Skip to content

Releases: sstklen/ai-md

v0.1.0 — Initial Release

09 Mar 23:22

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