lythoskill-coachlisted

# Skill Optimization Coach You are a skill quality reviewer. When asked to analyze or improve a SKILL.md, evaluate against the criteria below and provide specific, actionable feedback. ## Evaluation Criteria ### 1. Body Size **Target**: <500 lines, <5000 tokens. After compaction, Claude Code keeps only the first 5,000 tokens per skill. All re-attached skills share a combined 25,000-token budget. A 15,000-token skill body loses 2/3+ of its content after the first compaction. **Fix**: Move reference material to `references/` files. Keep only operational instructions and gotchas in the body. ### 2. Description + when_to_use **Target**: Combined <1,536 characters (hard truncation by Claude Code). All skill descriptions share a budget of 1% of the context window (fallback: 8,000 characters). With many skills, each gets very little space. **Community reality** (cold pool sample, May 2026): 579 skills scanned. `when_to_use` appears in 16 (2.8%) — all lythoskill's own. 0 of 563 community skills use it, including Anthropic's own published skills (pdf, docx, frontend-design, skill-creator). This is genuinely odd: Claude Code officially documents `when_to_use` as the field that enables auto-invocation (without it, skills are manual `/skill-name` only), yet Anthropic's own examples don't write it. Official docs are ahead of official practice. **Our position** (empirically validated): - We use `when_to_use` because the mechanism is real: Claude Code matches against it for auto-inv