Commit 0dba26d
feat: add component comparison section to agent-development skill (#15)
## Summary
- Add comparison table showing when to use agents vs commands vs skills
- Add decision criteria sections for each component type
- Help users choose the right component for their use case
## Problem
Fixes #11
Users may not know which plugin component is appropriate for their use
case. The agent-development skill explains how to create agents but
doesn't help users understand WHEN to use agents versus commands or
skills.
## Solution
Added a new "When to Use Agents vs Commands vs Skills" section after the
Overview in the agent-development skill. This includes:
- **Comparison table** - Quick reference showing component, best use
case, triggering method, and example
- **Choose Agents When** - Criteria for selecting agents
- **Choose Commands When** - Criteria for selecting commands
- **Choose Skills When** - Criteria for selecting skills
### Alternatives Considered
1. **Separate reference file** - Could have added as
`references/component-comparison.md` but decided inline was better for
discoverability since this is foundational knowledge users need early
2. **Full detailed guide** - Could have added more extensive examples,
but kept it concise to match the skill's lean style
## Changes
- `plugins/plugin-dev/skills/agent-development/SKILL.md`: Added 29-line
comparison section after Overview
## Testing
- [x] Linting passes (`markdownlint`)
- [x] Content matches acceptance criteria from issue
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>1 parent ff614dc commit 0dba26d
1 file changed
Lines changed: 29 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
20 | 49 | | |
21 | 50 | | |
22 | 51 | | |
| |||
0 commit comments