ai-md

npx skills add majiayu000/claude-skill-registry --skill ai-md --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# AI.MD v4 — The Complete AI-Native Conversion System ## When to Use This Skill - Use when your CLAUDE.md is long but AI still ignores your rules - Use when token usage is too high from verbose system instructions - Use when you want to optimize any LLM system prompt for compliance - Use when migrating rules between AI tools (Claude, Codex, Gemini, Grok) ## What Is AI.MD? AI.MD is a methodology for converting human-written `CLAUDE.md` (or any LLM system instructions) into a structured-label format that AI models follow more reliably, using fewer tokens. **The paradox we proved:** Adding more rules in natural language DECREASES compliance. Converting the same rules to structured format RESTORES and EXCEEDS it. ``` Human prose (6 rules, 1 line) → AI follows 4 of them Structured labels (6 rules, 6 lines) → AI follows all 6 Same content. Different format. Different results. ``` --- ## Why It Works: How LLMs Actually Process Instructions LLMs don't "read" — they **attend**. Understanding this changes everything. ### Mechanism 1: Attention Splitting When multiple rules share one line, the model's attention distributes across all tokens equally. Each rule gets a fraction of the attention

echo "=== Current Token Burn ==="
echo "CLAUDE.md:     $claude_md bytes"
echo "rules/*.md:    $rules bytes"
echo "Total:         $total bytes ≈ $tokens tokens/turn"
echo "50-turn session: ≈ $((tokens * 50)) tokens on instructions alone"