From ca7c2009a9dba345509860636e9ed8b2d9b8002a Mon Sep 17 00:00:00 2001 From: Steve Nims Date: Sun, 7 Dec 2025 20:56:18 -0500 Subject: [PATCH] docs(agent-development): add minimal working example after Overview MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a Quick Start section immediately after the Overview with a ~25-line copy-paste ready agent example. This helps new users get started quickly before diving into the comprehensive Complete Format section. Also improved the model field recommendation to more clearly emphasize `inherit` as the recommended default with specific guidance on when to use `haiku` or `opus` instead. Word count remains under 2,000 (1,891 words). Fixes #25 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../skills/agent-development/SKILL.md | 38 ++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/plugins/plugin-dev/skills/agent-development/SKILL.md b/plugins/plugin-dev/skills/agent-development/SKILL.md index 5bc7890..8088d72 100644 --- a/plugins/plugin-dev/skills/agent-development/SKILL.md +++ b/plugins/plugin-dev/skills/agent-development/SKILL.md @@ -18,6 +18,40 @@ Agents are autonomous subprocesses that handle complex, multi-step tasks indepen > **⚠️ Field Name Difference:** Agents use `tools` to restrict tool access. Skills use `allowed-tools` for the same purpose. Don't confuse these when switching between component types. +## Quick Start + +Minimal working agent (copy-paste ready): + +```markdown +--- +name: my-reviewer +description: Use this agent when the user asks to review code. Examples: + + +Context: User wrote new code +user: "Review my changes" +assistant: "I'll use the my-reviewer agent to analyze the code." + +Code review request triggers the agent. + + + +model: inherit +color: blue +--- + +You are a code reviewer. Analyze code for issues and provide feedback. + +**Process:** +1. Read the code +2. Identify issues +3. Provide recommendations + +**Output:** Summary with file:line references for each finding. +``` + +For complete format with all options, see [Agent File Structure](#agent-file-structure). + ## When to Use Agents vs Commands vs Skills | Component | Best For | Triggering | Example Use Case | @@ -164,7 +198,9 @@ Which model the agent should use. - `sonnet` - Balanced performance; most use cases (default recommendation) - `opus` - Complex reasoning; detailed analysis; highest capability needed -**Recommendation:** Use `inherit` unless agent needs specific model capabilities. +**Recommendation:** Use `inherit` (recommended default) unless the agent specifically needs: +- `haiku` for fast, cost-sensitive operations +- `opus` for complex reasoning requiring maximum capability ### color (required)