mirror of
https://github.com/obra/superpowers.git
synced 2026-04-21 17:09:07 +08:00
Add cross-referencing guidance to writing-skills
Added section "5. Cross-Referencing Other Skills" under CSO, explaining:
- Proper format: skills/path/name (no @ prefix or /SKILL.md suffix)
- Why: @ syntax force-loads files, burning context unnecessarily
- How to read: Use Read tool on ${CLAUDE_PLUGIN_ROOT}/skills/path/SKILL.md
This completes the move of cross-referencing guidance from getting-started
to writing-skills, improving separation of concerns.
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user