From a92e0487f02ac7811336af85fc53d87a9b2fd2b8 Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Sun, 7 Dec 2025 19:38:57 -0500 Subject: [PATCH] feat: add component comparison section to agent-development skill MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add new section helping users decide when to use agents vs commands vs skills. Includes comparison table and decision criteria for each component type. Fixes #11 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../skills/agent-development/SKILL.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/plugins/plugin-dev/skills/agent-development/SKILL.md b/plugins/plugin-dev/skills/agent-development/SKILL.md index 73c5e3e..93ff9f3 100644 --- a/plugins/plugin-dev/skills/agent-development/SKILL.md +++ b/plugins/plugin-dev/skills/agent-development/SKILL.md @@ -17,6 +17,35 @@ Agents are autonomous subprocesses that handle complex, multi-step tasks indepen - System prompt defines agent behavior - Model and color customization +## When to Use Agents vs Commands vs Skills + +| Component | Best For | Triggering | Example Use Case | +|-----------|----------|------------|------------------| +| **Agents** | Autonomous multi-step tasks | Proactive or description-matched | Code review after implementation | +| **Commands** | User-initiated actions | Explicit `/command` invocation | `/deploy production` | +| **Skills** | Knowledge and guidance | Model-invoked based on context | Domain expertise for PDF processing | + +### Choose Agents When + +- Task requires autonomous, multi-step execution +- Proactive triggering after certain events is desired +- Specialized subprocess with focused tools needed +- Work should happen in the background or as a subagent + +### Choose Commands When + +- User should explicitly trigger the action +- Task has clear start/end with specific inputs +- Action should not happen automatically +- Workflow requires user confirmation at each step + +### Choose Skills When + +- Providing knowledge or procedural guidance +- Extending Claude's domain expertise +- No autonomous execution needed +- Information should be available contextually on-demand + ## Agent File Structure ### Complete Format