Skip to content

v0.1.0 β€” Initial Release

Latest

Choose a tag to compare

@sstklen sstklen released this 09 Mar 23:22
· 3 commits to main since this release

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