Skip to content

Commit 0dba26d

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

File tree

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

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

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,35 @@ Agents are autonomous subprocesses that handle complex, multi-step tasks indepen
1717
- System prompt defines agent behavior
1818
- Model and color customization
1919

20+
## When to Use Agents vs Commands vs Skills
21+
22+
| Component | Best For | Triggering | Example Use Case |
23+
|-----------|----------|------------|------------------|
24+
| **Agents** | Autonomous multi-step tasks | Proactive or description-matched | Code review after implementation |
25+
| **Commands** | User-initiated actions | Explicit `/command` invocation | `/deploy production` |
26+
| **Skills** | Knowledge and guidance | Model-invoked based on context | Domain expertise for PDF processing |
27+
28+
### Choose Agents When
29+
30+
- Task requires autonomous, multi-step execution
31+
- Proactive triggering after certain events is desired
32+
- Specialized subprocess with focused tools needed
33+
- Work should happen in the background or as a subagent
34+
35+
### Choose Commands When
36+
37+
- User should explicitly trigger the action
38+
- Task has clear start/end with specific inputs
39+
- Action should not happen automatically
40+
- Workflow requires user confirmation at each step
41+
42+
### Choose Skills When
43+
44+
- Providing knowledge or procedural guidance
45+
- Extending Claude's domain expertise
46+
- No autonomous execution needed
47+
- Information should be available contextually on-demand
48+
2049
## Agent File Structure
2150

2251
### Complete Format

0 commit comments

Comments
 (0)