Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Releases: sstklen/ai-md

v0.1.0 — Initial Release

09 Mar 23:22
@sstklen sstklen

Choose a tag to compare

AI.MD v0.1.0

Convert human-written CLAUDE.md into AI-native structured-label format.

What it does

  • -53% file size (13,474 → 6,332 bytes)
  • -37% line count (224 → 142 lines, within Claude Code's 200-line recommendation)
  • Rule compliance 6/8 → 8/8 (tested across 4 LLM models)

Same rules, zero deletions — just restructured for how LLMs actually parse.

10 Techniques

  1. One concept per line
  2. Explicit trigger/action/exception labels
  3. Semantic anchors (labels as hashtags)
  4. State-machine gates (if → then → else → priority)
  5. XML section isolation
  6. Strip all "why" — keep only "what"
  7. Bilingual labels (English for AI, native language for human output)
  8. Cross-references instead of repetition
  9. Not-triggered lists (explicit exclusions)
  10. Conflict detection with priority resolution

Install

mkdir -p ~/.claude/skills/ai-md && curl -o ~/.claude/skills/ai-md/SKILL.md https://raw.githubusercontent.com/sstklen/ai-md/main/SKILL.md

Then say "AI.MD" or "distill my CLAUDE.md" to Claude Code.

Includes

  • SKILL.md — The skill (install this)
  • examples/before.md — Sample CLAUDE.md in natural language
  • examples/after.md — Same rules converted to AI-native format
Assets 2
Loading

AltStyle によって変換されたページ (->オリジナル) /