An agentic skills framework & software development methodology that works.
Add cross-referencing guidance to writing-skills
Jesse Vincent2227e3151e7f
diff --git a/skills/meta/writing-skills/SKILL.md b/skills/meta/writing-skills/SKILL.mdindex 57e71748d..60850f85f 100644--- a/skills/meta/writing-skills/SKILL.md+++ b/skills/meta/writing-skills/SKILL.md@@ -237,6 +237,19 @@ Mention key concepts multiple times:Grep hits from multiple places = easier discovery+### 5. Cross-Referencing Other Skills++**When writing documentation that references other skills:**++Use path format without `@` prefix or `/SKILL.md` suffix:+- ✅ Good: `skills/testing/test-driven-development`+- ✅ Good: `skills/debugging/systematic-debugging`+- ❌ Bad: `@skills/testing/test-driven-development/SKILL.md` (force-loads, burns context)++**Why no @ links:** `@` syntax force-loads files immediately, consuming 200k+ context before you need them.++**To read a skill reference:** Use Read tool on `${CLAUDE_PLUGIN_ROOT}/skills/category/skill-name/SKILL.md`+## Flowchart Usage```dot