Commit 5807828
feat(agent-development): add cross-references to related skills (#21)
## Summary
- Add blockquote after comparison table linking to `command-development`
and `skill-development` skills
- Add cross-reference after "Choose Commands When" section
- Add cross-reference after "Choose Skills When" section
## Problem
Fixes #18
Users reading the agent-development skill's comparison section (agents
vs commands vs skills) had no direct links to learn more about
developing those other component types.
## Solution
Added three cross-references to help users discover related skills:
1. A blockquote after the comparison table: "See also: For command
development, load the `command-development` skill. For skill
development, load the `skill-development` skill."
2. After "Choose Commands When": reference to `command-development`
skill
3. After "Choose Skills When": reference to `skill-development` skill
### Alternatives Considered
- Adding hyperlinks: Not applicable since skills are invoked by name,
not URLs
- Adding to a separate "Related Skills" section: Would be less
discoverable; inline references are more contextual
## Changes
- `plugins/plugin-dev/skills/agent-development/SKILL.md`: Added 3
cross-references (6 lines)
## Testing
- [x] Word count verified: 1,672 words (within 1,500-2,000 ideal range)
- [x] Linting passes: `markdownlint` shows no issues
- [x] Cross-referenced skills exist and are valid
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>1 parent 41f7c8b commit 5807828
1 file changed
Lines changed: 6 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
| 27 | + | |
| 28 | + | |
27 | 29 | | |
28 | 30 | | |
29 | 31 | | |
| |||
38 | 40 | | |
39 | 41 | | |
40 | 42 | | |
| 43 | + | |
| 44 | + | |
41 | 45 | | |
42 | 46 | | |
43 | 47 | | |
44 | 48 | | |
45 | 49 | | |
46 | 50 | | |
47 | 51 | | |
| 52 | + | |
| 53 | + | |
48 | 54 | | |
49 | 55 | | |
50 | 56 | | |
| |||
0 commit comments