Agent Development — Skillopedia

Agent Development for Claude Code Plugins Overview Agents are autonomous subprocesses that handle complex, multi-step tasks independently. Understanding agent structure, triggering conditions, and system prompt design enables creating powerful autonomous capabilities. Key concepts: - Agents are FOR autonomous work, commands are FOR user-initiated actions - Markdown file format with YAML frontmatter - Triggering via description field with examples - System prompt defines agent behavior - Model and color customization Agent File Structure Complete Format Frontmatter Fields name (required) Agent…

; then\n echo \"❌ Frontmatter not closed (missing second ---)\"\n exit 1\nfi\necho \"✅ Frontmatter properly closed\"\n\n# Extract frontmatter and system prompt\nFRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' \"$AGENT_FILE\")\nSYSTEM_PROMPT=$(awk '/^---$/{i++; next} i>=2' \"$AGENT_FILE\")\n\n# Check 4: Required fields\necho \"\"\necho \"Checking required fields...\"\n\nerror_count=0\nwarning_count=0\n\n# Check name field\nNAME=$(echo \"$FRONTMATTER\" | grep '^name:' | sed 's/name: *//' | sed 's/^\"\$.*\$\"$/\\1/')\n\nif [ -z \"$NAME\" ]; then\n echo \"❌ Missing required field: name\"\n ((error_count++))\nelse\n echo \"✅ name: $NAME\"\n\n # Validate name format\n if ! [[ \"$NAME\" =~ ^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$ ]]; then\n echo \"❌ name must start/end with alphanumeric and contain only letters, numbers, hyphens\"\n ((error_count++))\n fi\n\n # Validate name length\n name_length=${#NAME}\n if [ $name_length -lt 3 ]; then\n echo \"❌ name too short (minimum 3 characters)\"\n ((error_count++))\n elif [ $name_length -gt 50 ]; then\n echo \"❌ name too long (maximum 50 characters)\"\n ((error_count++))\n fi\n\n # Check for generic names\n if [[ \"$NAME\" =~ ^(helper|assistant|agent|tool)$ ]]; then\n echo \"⚠️ name is too generic: $NAME\"\n ((warning_count++))\n fi\nfi\n\n# Check description field\nDESCRIPTION=$(echo \"$FRONTMATTER\" | grep '^description:' | sed 's/description: *//')\n\nif [ -z \"$DESCRIPTION\" ]; then\n echo \"❌ Missing required field: description\"\n ((error_count++))\nelse\n desc_length=${#DESCRIPTION}\n echo \"✅ description: ${desc_length} characters\"\n\n if [ $desc_length -lt 10 ]; then\n echo \"⚠️ description too short (minimum 10 characters recommended)\"\n ((warning_count++))\n elif [ $desc_length -gt 5000 ]; then\n echo \"⚠️ description very long (over 5000 characters)\"\n ((warning_count++))\n fi\n\n # Check for example blocks\n if ! echo \"$DESCRIPTION\" | grep -q '\u003cexample>'; then\n echo \"⚠️ description should include \u003cexample> blocks for triggering\"\n ((warning_count++))\n fi\n\n # Check for \"Use this agent when\" pattern\n if ! echo \"$DESCRIPTION\" | grep -qi 'use this agent when'; then\n echo \"⚠️ description should start with 'Use this agent when...'\"\n ((warning_count++))\n fi\nfi\n\n# Check model field\nMODEL=$(echo \"$FRONTMATTER\" | grep '^model:' | sed 's/model: *//')\n\nif [ -z \"$MODEL\" ]; then\n echo \"❌ Missing required field: model\"\n ((error_count++))\nelse\n echo \"✅ model: $MODEL\"\n\n case \"$MODEL\" in\n inherit|sonnet|opus|haiku)\n # Valid model\n ;;\n *)\n echo \"⚠️ Unknown model: $MODEL (valid: inherit, sonnet, opus, haiku)\"\n ((warning_count++))\n ;;\n esac\nfi\n\n# Check color field\nCOLOR=$(echo \"$FRONTMATTER\" | grep '^color:' | sed 's/color: *//')\n\nif [ -z \"$COLOR\" ]; then\n echo \"❌ Missing required field: color\"\n ((error_count++))\nelse\n echo \"✅ color: $COLOR\"\n\n case \"$COLOR\" in\n blue|cyan|green|yellow|magenta|red)\n # Valid color\n ;;\n *)\n echo \"⚠️ Unknown color: $COLOR (valid: blue, cyan, green, yellow, magenta, red)\"\n ((warning_count++))\n ;;\n esac\nfi\n\n# Check tools field (optional)\nTOOLS=$(echo \"$FRONTMATTER\" | grep '^tools:' | sed 's/tools: *//')\n\nif [ -n \"$TOOLS\" ]; then\n echo \"✅ tools: $TOOLS\"\nelse\n echo \"💡 tools: not specified (agent has access to all tools)\"\nfi\n\n# Check 5: System prompt\necho \"\"\necho \"Checking system prompt...\"\n\nif [ -z \"$SYSTEM_PROMPT\" ]; then\n echo \"❌ System prompt is empty\"\n ((error_count++))\nelse\n prompt_length=${#SYSTEM_PROMPT}\n echo \"✅ System prompt: $prompt_length characters\"\n\n if [ $prompt_length -lt 20 ]; then\n echo \"❌ System prompt too short (minimum 20 characters)\"\n ((error_count++))\n elif [ $prompt_length -gt 10000 ]; then\n echo \"⚠️ System prompt very long (over 10,000 characters)\"\n ((warning_count++))\n fi\n\n # Check for second person\n if ! echo \"$SYSTEM_PROMPT\" | grep -q \"You are\\|You will\\|Your\"; then\n echo \"⚠️ System prompt should use second person (You are..., You will...)\"\n ((warning_count++))\n fi\n\n # Check for structure\n if ! echo \"$SYSTEM_PROMPT\" | grep -qi \"responsibilities\\|process\\|steps\"; then\n echo \"💡 Consider adding clear responsibilities or process steps\"\n fi\n\n if ! echo \"$SYSTEM_PROMPT\" | grep -qi \"output\"; then\n echo \"💡 Consider defining output format expectations\"\n fi\nfi\n\necho \"\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\n\nif [ $error_count -eq 0 ] && [ $warning_count -eq 0 ]; then\n echo \"✅ All checks passed!\"\n exit 0\nelif [ $error_count -eq 0 ]; then\n echo \"⚠️ Validation passed with $warning_count warning(s)\"\n exit 0\nelse\n echo \"❌ Validation failed with $error_count error(s) and $warning_count warning(s)\"\n exit 1\nfi\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":5796,"content_sha256":"d22e1292f997169fb745793dc50ebe3e9c6631603e1d77f04c2e79bb1fc63cba"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Agent Development for Claude Code Plugins","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents are autonomous subprocesses that handle complex, multi-step tasks independently. Understanding agent structure, triggering conditions, and system prompt design enables creating powerful autonomous capabilities.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key concepts:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Agents are FOR autonomous work, commands are FOR user-initiated actions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Markdown file format with YAML frontmatter","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Triggering via description field with examples","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"System prompt defines agent behavior","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Model and color customization","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Agent File Structure","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Complete Format","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"---\nname: agent-identifier\ndescription: Use this agent when [triggering conditions]. Examples:\n\n\u003cexample>\nContext: [Situation description]\nuser: \"[User request]\"\nassistant: \"[How assistant should respond and use this agent]\"\n\u003ccommentary>\n[Why this agent should be triggered]\n\u003c/commentary>\n\u003c/example>\n\n\u003cexample>\n[Additional example...]\n\u003c/example>\n\nmodel: inherit\ncolor: blue\ntools: [\"Read\", \"Write\", \"Grep\"]\n---\n\nYou are [agent role description]...\n\n**Your Core Responsibilities:**\n1. [Responsibility 1]\n2. [Responsibility 2]\n\n**Analysis Process:**\n[Step-by-step workflow]\n\n**Output Format:**\n[What to return]","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Frontmatter Fields","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"name (required)","type":"text"}]},{"type":"paragraph","content":[{"text":"Agent identifier used for namespacing and invocation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Format:","type":"text","marks":[{"type":"strong"}]},{"text":" lowercase, numbers, hyphens only ","type":"text"},{"text":"Length:","type":"text","marks":[{"type":"strong"}]},{"text":" 3-50 characters ","type":"text"},{"text":"Pattern:","type":"text","marks":[{"type":"strong"}]},{"text":" Must start and end with alphanumeric","type":"text"}]},{"type":"paragraph","content":[{"text":"Good examples:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"code-reviewer","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"test-generator","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"api-docs-writer","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"security-analyzer","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Bad examples:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"helper","type":"text","marks":[{"type":"code_inline"}]},{"text":" (too generic)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"-agent-","type":"text","marks":[{"type":"code_inline"}]},{"text":" (starts/ends with hyphen)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"my_agent","type":"text","marks":[{"type":"code_inline"}]},{"text":" (underscores not allowed)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"ag","type":"text","marks":[{"type":"code_inline"}]},{"text":" (too short, \u003c 3 chars)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"description (required)","type":"text"}]},{"type":"paragraph","content":[{"text":"Defines when Claude should trigger this agent. ","type":"text"},{"text":"This is the most critical field.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Must include:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Triggering conditions (\"Use this agent when...\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Multiple ","type":"text"},{"text":"\u003cexample>","type":"text","marks":[{"type":"code_inline"}]},{"text":" blocks showing usage","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Context, user request, and assistant response in each example","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\u003ccommentary>","type":"text","marks":[{"type":"code_inline"}]},{"text":" explaining why agent triggers","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Format:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Use this agent when [conditions]. Examples:\n\n\u003cexample>\nContext: [Scenario description]\nuser: \"[What user says]\"\nassistant: \"[How Claude should respond]\"\n\u003ccommentary>\n[Why this agent is appropriate]\n\u003c/commentary>\n\u003c/example>\n\n[More examples...]","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practices:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Include 2-4 concrete examples","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Show proactive and reactive triggering","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Cover different phrasings of same intent","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Explain reasoning in commentary","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Be specific about when NOT to use the agent","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"model (required)","type":"text"}]},{"type":"paragraph","content":[{"text":"Which model the agent should use.","type":"text"}]},{"type":"paragraph","content":[{"text":"Options:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"inherit","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Use same model as parent (recommended)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"sonnet","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Claude Sonnet (balanced)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"opus","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Claude Opus (most capable, expensive)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"haiku","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Claude Haiku (fast, cheap)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Recommendation:","type":"text","marks":[{"type":"strong"}]},{"text":" Use ","type":"text"},{"text":"inherit","type":"text","marks":[{"type":"code_inline"}]},{"text":" unless agent needs specific model capabilities.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"color (required)","type":"text"}]},{"type":"paragraph","content":[{"text":"Visual identifier for agent in UI.","type":"text"}]},{"type":"paragraph","content":[{"text":"Options:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"blue","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"cyan","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"green","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"yellow","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"magenta","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"red","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Guidelines:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choose distinct colors for different agents in same plugin","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use consistent colors for similar agent types","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Blue/cyan: Analysis, review","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Green: Success-oriented tasks","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Yellow: Caution, validation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Red: Critical, security","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Magenta: Creative, generation","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"tools (optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"Restrict agent to specific tools.","type":"text"}]},{"type":"paragraph","content":[{"text":"Format:","type":"text","marks":[{"type":"strong"}]},{"text":" Array of tool names","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"yaml"},"content":[{"text":"tools: [\"Read\", \"Write\", \"Grep\", \"Bash\"]","type":"text"}]},{"type":"paragraph","content":[{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" If omitted, agent has access to all tools","type":"text"}]},{"type":"paragraph","content":[{"text":"Best practice:","type":"text","marks":[{"type":"strong"}]},{"text":" Limit tools to minimum needed (principle of least privilege)","type":"text"}]},{"type":"paragraph","content":[{"text":"Common tool sets:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read-only analysis: ","type":"text"},{"text":"[\"Read\", \"Grep\", \"Glob\"]","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Code generation: ","type":"text"},{"text":"[\"Read\", \"Write\", \"Grep\"]","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Testing: ","type":"text"},{"text":"[\"Read\", \"Bash\", \"Grep\"]","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Full access: Omit field or use ","type":"text"},{"text":"[\"*\"]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"System Prompt Design","type":"text"}]},{"type":"paragraph","content":[{"text":"The markdown body becomes the agent's system prompt. Write in second person, addressing the agent directly.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Standard template:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"You are [role] specializing in [domain].\n\n**Your Core Responsibilities:**\n1. [Primary responsibility]\n2. [Secondary responsibility]\n3. [Additional responsibilities...]\n\n**Analysis Process:**\n1. [Step one]\n2. [Step two]\n3. [Step three]\n[...]\n\n**Quality Standards:**\n- [Standard 1]\n- [Standard 2]\n\n**Output Format:**\nProvide results in this format:\n- [What to include]\n- [How to structure]\n\n**Edge Cases:**\nHandle these situations:\n- [Edge case 1]: [How to handle]\n- [Edge case 2]: [How to handle]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Best Practices","type":"text"}]},{"type":"paragraph","content":[{"text":"✅ ","type":"text"},{"text":"DO:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write in second person (\"You are...\", \"You will...\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Be specific about responsibilities","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Provide step-by-step process","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Define output format","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Include quality standards","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Address edge cases","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Keep under 10,000 characters","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"❌ ","type":"text"},{"text":"DON'T:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write in first person (\"I am...\", \"I will...\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Be vague or generic","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Omit process steps","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Leave output format undefined","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Skip quality guidance","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ignore error cases","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating Agents","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Method 1: AI-Assisted Generation","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this prompt pattern (extracted from Claude Code):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Create an agent configuration based on this request: \"[YOUR DESCRIPTION]\"\n\nRequirements:\n1. Extract core intent and responsibilities\n2. Design expert persona for the domain\n3. Create comprehensive system prompt with:\n - Clear behavioral boundaries\n - Specific methodologies\n - Edge case handling\n - Output format\n4. Create identifier (lowercase, hyphens, 3-50 chars)\n5. Write description with triggering conditions\n6. Include 2-3 \u003cexample> blocks showing when to use\n\nReturn JSON with:\n{\n \"identifier\": \"agent-name\",\n \"whenToUse\": \"Use this agent when... Examples: \u003cexample>...\u003c/example>\",\n \"systemPrompt\": \"You are...\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Then convert to agent file format with frontmatter.","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"examples/agent-creation-prompt.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" for complete template.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Method 2: Manual Creation","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choose agent identifier (3-50 chars, lowercase, hyphens)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write description with examples","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Select model (usually ","type":"text"},{"text":"inherit","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choose color for visual identification","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Define tools (if restricting access)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write system prompt with structure above","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Save as ","type":"text"},{"text":"agents/agent-name.md","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validation Rules","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Identifier Validation","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"✅ Valid: code-reviewer, test-gen, api-analyzer-v2\n❌ Invalid: ag (too short), -start (starts with hyphen), my_agent (underscore)","type":"text"}]},{"type":"paragraph","content":[{"text":"Rules:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"3-50 characters","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Lowercase letters, numbers, hyphens only","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Must start and end with alphanumeric","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"No underscores, spaces, or special characters","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Description Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"Length:","type":"text","marks":[{"type":"strong"}]},{"text":" 10-5,000 characters ","type":"text"},{"text":"Must include:","type":"text","marks":[{"type":"strong"}]},{"text":" Triggering conditions and examples ","type":"text"},{"text":"Best:","type":"text","marks":[{"type":"strong"}]},{"text":" 200-1,000 characters with 2-4 examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"System Prompt Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"Length:","type":"text","marks":[{"type":"strong"}]},{"text":" 20-10,000 characters ","type":"text"},{"text":"Best:","type":"text","marks":[{"type":"strong"}]},{"text":" 500-3,000 characters ","type":"text"},{"text":"Structure:","type":"text","marks":[{"type":"strong"}]},{"text":" Clear responsibilities, process, output format","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Agent Organization","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Plugin Agents Directory","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"plugin-name/\n└── agents/\n ├── analyzer.md\n ├── reviewer.md\n └── generator.md","type":"text"}]},{"type":"paragraph","content":[{"text":"All ","type":"text"},{"text":".md","type":"text","marks":[{"type":"code_inline"}]},{"text":" files in ","type":"text"},{"text":"agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":" are auto-discovered.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Namespacing","type":"text"}]},{"type":"paragraph","content":[{"text":"Agents are namespaced automatically:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Single plugin: ","type":"text"},{"text":"agent-name","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"With subdirectories: ","type":"text"},{"text":"plugin:subdir:agent-name","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Testing Agents","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test Triggering","type":"text"}]},{"type":"paragraph","content":[{"text":"Create test scenarios to verify agent triggers correctly:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write agent with specific triggering examples","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use similar phrasing to examples in test","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check Claude loads the agent","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify agent provides expected functionality","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test System Prompt","type":"text"}]},{"type":"paragraph","content":[{"text":"Ensure system prompt is complete:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Give agent typical task","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check it follows process steps","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify output format is correct","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Test edge cases mentioned in prompt","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Confirm quality standards are met","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Reference","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Minimal Agent","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"---\nname: simple-agent\ndescription: Use this agent when... Examples: \u003cexample>...\u003c/example>\nmodel: inherit\ncolor: blue\n---\n\nYou are an agent that [does X].\n\nProcess:\n1. [Step 1]\n2. [Step 2]\n\nOutput: [What to provide]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Frontmatter Fields Summary","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"name","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"lowercase-hyphens","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"code-reviewer","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"description","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Text + examples","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use when... \u003cexample>...","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"model","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"inherit/sonnet/opus/haiku","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"inherit","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"color","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Color name","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"blue","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"tools","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Array of tool names","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[\"Read\", \"Grep\"]","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Best Practices","type":"text"}]},{"type":"paragraph","content":[{"text":"DO:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Include 2-4 concrete examples in description","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Write specific triggering conditions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Use ","type":"text"},{"text":"inherit","type":"text","marks":[{"type":"code_inline"}]},{"text":" for model unless specific need","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Choose appropriate tools (least privilege)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Write clear, structured system prompts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"✅ Test agent triggering thoroughly","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DON'T:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Use generic descriptions without examples","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Omit triggering conditions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Give all agents same color","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Grant unnecessary tool access","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Write vague system prompts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"❌ Skip testing","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Additional Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reference Files","type":"text"}]},{"type":"paragraph","content":[{"text":"For detailed guidance, consult:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/system-prompt-design.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - Complete system prompt patterns","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/triggering-examples.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - Example formats and best practices","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/agent-creation-system-prompt.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - The exact prompt from Claude Code","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example Files","type":"text"}]},{"type":"paragraph","content":[{"text":"Working examples in ","type":"text"},{"text":"examples/","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"agent-creation-prompt.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - AI-assisted agent generation template","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complete-agent-examples.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - Full agent examples for different use cases","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Utility Scripts","type":"text"}]},{"type":"paragraph","content":[{"text":"Development tools in ","type":"text"},{"text":"scripts/","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"validate-agent.sh","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - Validate agent file structure","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"test-agent-trigger.sh","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" - Test if agent triggers correctly","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an agent for a plugin:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Define agent purpose and triggering conditions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Choose creation method (AI-assisted or manual)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text"},{"text":"agents/agent-name.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" file","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write frontmatter with all required fields","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write system prompt following best practices","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Include 2-4 triggering examples in description","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validate with ","type":"text"},{"text":"scripts/validate-agent.sh","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Test triggering with real scenarios","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Document agent in plugin README","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Focus on clear triggering conditions and comprehensive system prompts for autonomous operation.","type":"text"}]}]},"metadata":{"date":"2026-06-05","name":"Agent Development","author":"@skillopedia","source":{"stars":129313,"repo_name":"claude-code","origin_url":"https://github.com/anthropics/claude-code/blob/HEAD/plugins/plugin-dev/skills/agent-development/SKILL.md","repo_owner":"anthropics","body_sha256":"c7d43d1cad7826bb73636089761d210ef97779db13da146c5adf70e2d2a79baa","cluster_key":"23a6ee40f5f1021145d1af6390399b6daf0b162c2703fc1487e3b78d8315734f","clean_bundle":{"format":"clean-skill-bundle-v1","source":"anthropics/claude-code/plugins/plugin-dev/skills/agent-development/SKILL.md","attachments":[{"id":"c17e8ab7-1aac-501f-b112-294bac8b2dc7","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c17e8ab7-1aac-501f-b112-294bac8b2dc7/attachment.md","path":"examples/agent-creation-prompt.md","size":9390,"sha256":"fddc24d6f7c67722e5c007087d19606cf116a89f3360519c2ae8f52989f40a4d","contentType":"text/markdown; charset=utf-8"},{"id":"e36e441b-2971-565c-9d96-979ada759f42","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e36e441b-2971-565c-9d96-979ada759f42/attachment.md","path":"examples/complete-agent-examples.md","size":14117,"sha256":"36fde2ac46665ba98804ec0fb6e94022795cba063e932d670c9463deedd30e72","contentType":"text/markdown; charset=utf-8"},{"id":"9a84d84d-1f33-523e-af26-2fb8170d5ceb","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/9a84d84d-1f33-523e-af26-2fb8170d5ceb/attachment.md","path":"references/agent-creation-system-prompt.md","size":8879,"sha256":"35ea11d43d8462f7a281f9becd99e69fe1cdd9d80b4024cef7092a03f0f73ca1","contentType":"text/markdown; charset=utf-8"},{"id":"09ee7ee3-50a6-5fef-9e41-bed561c732e5","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/09ee7ee3-50a6-5fef-9e41-bed561c732e5/attachment.md","path":"references/system-prompt-design.md","size":9998,"sha256":"eaac53eaaf8326ac04428987280fb5041920b7571477ad41742517c5aac683fc","contentType":"text/markdown; charset=utf-8"},{"id":"b0a73ace-25a6-5e49-a9bf-24d83001f51d","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/b0a73ace-25a6-5e49-a9bf-24d83001f51d/attachment.md","path":"references/triggering-examples.md","size":11613,"sha256":"2a5ea013c97fc9f2c1ed55f96c6d5da2c2378695f7714bfb2c2e61bfbc9d228f","contentType":"text/markdown; charset=utf-8"},{"id":"4fc2710c-c10f-5af0-9906-5fbc91fe438a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/4fc2710c-c10f-5af0-9906-5fbc91fe438a/attachment.sh","path":"scripts/validate-agent.sh","size":5796,"sha256":"d22e1292f997169fb745793dc50ebe3e9c6631603e1d77f04c2e79bb1fc63cba","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"3d5c53491c826ec0788ff53d28293646bb8c1a702f116da7b79b7f173878c71b","attachment_count":6,"text_attachments":6,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":11,"skill_md_path":"plugins/plugin-dev/skills/agent-development/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"web-development","category_label":"Web"},"exact_dupes_collapsed_into_this":10},"version":"v1","category":"web-development","import_tag":"clean-skills-v1","description":"This skill should be used when the user asks to \"create an agent\", \"add an agent\", \"write a subagent\", \"agent frontmatter\", \"when to use description\", \"agent examples\", \"agent tools\", \"agent colors\", \"autonomous agent\", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins."}},"renderedAt":1782979421305}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.