Skip to content

Commit 5807828

Browse files
sjnimsclaude
andauthored
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

File tree

  • plugins/plugin-dev/skills/agent-development

plugins/plugin-dev/skills/agent-development/SKILL.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ Agents are autonomous subprocesses that handle complex, multi-step tasks indepen
2424
| **Commands** | User-initiated actions | Explicit `/command` invocation | `/deploy production` |
2525
| **Skills** | Knowledge and guidance | Model-invoked based on context | Domain expertise for PDF processing |
2626

27+
> **See also:** For command development, load the `command-development` skill. For skill development, load the `skill-development` skill.
28+
2729
### Choose Agents When
2830

2931
- Task requires autonomous, multi-step execution
@@ -38,13 +40,17 @@ Agents are autonomous subprocesses that handle complex, multi-step tasks indepen
3840
- Action should not happen automatically
3941
- Workflow requires user confirmation at each step
4042

43+
For command development guidance, see the `command-development` skill.
44+
4145
### Choose Skills When
4246

4347
- Providing knowledge or procedural guidance
4448
- Extending Claude's domain expertise
4549
- No autonomous execution needed
4650
- Information should be available contextually on-demand
4751

52+
For skill development guidance, see the `skill-development` skill.
53+
4854
## Agent File Structure
4955

5056
### Complete Format

0 commit comments

Comments
 (0)