surshar / claude-code
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
Built by Anthropic · github.com/anthropics
The description: field in these four agent files contained unquoted colon-space sequences (Examples:, Context:, user:, assistant:) that strict YAML parsers reject with "mapping values are not allowed in this context". Claude Code's own parser tolerates this, but third-party tooling and linters fail on it. Wraps each description in a |- literal block scalar with 2-space indentation so the frontmatter is spec-compliant YAML. Description text and agent body are byte-for-byte unchanged. Same approach as #44055 (which covers pr-review-toolkit only). Refs #40370
| Mplugins/hookify/agents/conversation-analyzer.md |
| Mplugins/plugin-dev/agents/agent-creator.md |
| Mplugins/plugin-dev/agents/plugin-validator.md |
| Mplugins/plugin-dev/agents/skill-reviewer.md |
| @@ -1,6 +1,13 @@ | ||
| 1 | 1 | --- |
| 2 | 2 | name: conversation-analyzer |
| 3 | -description: Use this agent when analyzing conversation transcripts to find behaviors worth preventing with hooks. Examples: <example>Context: User is running /hookify command without arguments\nuser: "/hookify"\nassistant: "I'll analyze the conversation to find behaviors you want to prevent"\n<commentary>The /hookify command without arguments triggers conversation analysis to find unwanted behaviors.</commentary></example><example>Context: User wants to create hooks from recent frustrations\nuser: "Can you look back at this conversation and help me create hooks for the mistakes you made?"\nassistant: "I'll use the conversation-analyzer agent to identify the issues and suggest hooks."\n<commentary>User explicitly asks to analyze conversation for mistakes that should be prevented.</commentary></example> | |
| 3 | +description: |- | |
| 4 | + Use this agent when analyzing conversation transcripts to find behaviors worth preventing with hooks. Examples: <example>Context: User is running /hookify command without arguments | |
| 5 | + user: "/hookify" | |
| 6 | + assistant: "I'll analyze the conversation to find behaviors you want to prevent" | |
| 7 | + <commentary>The /hookify command without arguments triggers conversation analysis to find unwanted behaviors.</commentary></example><example>Context: User wants to create hooks from recent frustrations | |
| 8 | + user: "Can you look back at this conversation and help me create hooks for the mistakes you made?" | |
| 9 | + assistant: "I'll use the conversation-analyzer agent to identify the issues and suggest hooks." | |
| 10 | + <commentary>User explicitly asks to analyze conversation for mistakes that should be prevented.</commentary></example> | |
| 4 | 11 | model: inherit |
| 5 | 12 | color: yellow |
| 6 | 13 | tools: ["Read", "Grep"] |
| @@ -1,33 +1,34 @@ | ||
| 1 | 1 | --- |
| 2 | 2 | name: agent-creator |
| 3 | -description: Use this agent when the user asks to "create an agent", "generate an agent", "build a new agent", "make me an agent that...", or describes agent functionality they need. Trigger when user wants to create autonomous agents for plugins. Examples: | |
| 3 | +description: |- | |
| 4 | + Use this agent when the user asks to "create an agent", "generate an agent", "build a new agent", "make me an agent that...", or describes agent functionality they need. Trigger when user wants to create autonomous agents for plugins. Examples: | |
| 4 | 5 | |
| 5 | -<example> | |
| 6 | -Context: User wants to create a code review agent | |
| 7 | -user: "Create an agent that reviews code for quality issues" | |
| 8 | -assistant: "I'll use the agent-creator agent to generate the agent configuration." | |
| 9 | -<commentary> | |
| 10 | -User requesting new agent creation, trigger agent-creator to generate it. | |
| 11 | -</commentary> | |
| 12 | -</example> | |
| 6 | + <example> | |
| 7 | + Context: User wants to create a code review agent | |
| 8 | + user: "Create an agent that reviews code for quality issues" | |
| 9 | + assistant: "I'll use the agent-creator agent to generate the agent configuration." | |
| 10 | + <commentary> | |
| 11 | + User requesting new agent creation, trigger agent-creator to generate it. | |
| 12 | + </commentary> | |
| 13 | + </example> | |
| 13 | 14 | |
| 14 | -<example> | |
| 15 | -Context: User describes needed functionality | |
| 16 | -user: "I need an agent that generates unit tests for my code" | |
| 17 | -assistant: "I'll use the agent-creator agent to create a test generation agent." | |
| 18 | -<commentary> | |
| 19 | -User describes agent need, trigger agent-creator to build it. | |
| 20 | -</commentary> | |
| 21 | -</example> | |
| 15 | + <example> | |
| 16 | + Context: User describes needed functionality | |
| 17 | + user: "I need an agent that generates unit tests for my code" | |
| 18 | + assistant: "I'll use the agent-creator agent to create a test generation agent." | |
| 19 | + <commentary> | |
| 20 | + User describes agent need, trigger agent-creator to build it. | |
| 21 | + </commentary> | |
| 22 | + </example> | |
| 22 | 23 | |
| 23 | -<example> | |
| 24 | -Context: User wants to add agent to plugin | |
| 25 | -user: "Add an agent to my plugin that validates configurations" | |
| 26 | -assistant: "I'll use the agent-creator agent to generate a configuration validator agent." | |
| 27 | -<commentary> | |
| 28 | -Plugin development with agent addition, trigger agent-creator. | |
| 29 | -</commentary> | |
| 30 | -</example> | |
| 24 | + <example> | |
| 25 | + Context: User wants to add agent to plugin | |
| 26 | + user: "Add an agent to my plugin that validates configurations" | |
| 27 | + assistant: "I'll use the agent-creator agent to generate a configuration validator agent." | |
| 28 | + <commentary> | |
| 29 | + Plugin development with agent addition, trigger agent-creator. | |
| 30 | + </commentary> | |
| 31 | + </example> | |
| 31 | 32 | |
| 32 | 33 | model: sonnet |
| 33 | 34 | color: magenta |
| @@ -1,35 +1,36 @@ | ||
| 1 | 1 | --- |
| 2 | 2 | name: plugin-validator |
| 3 | -description: Use this agent when the user asks to "validate my plugin", "check plugin structure", "verify plugin is correct", "validate plugin.json", "check plugin files", or mentions plugin validation. Also trigger proactively after user creates or modifies plugin components. Examples: | |
| 3 | +description: |- | |
| 4 | + Use this agent when the user asks to "validate my plugin", "check plugin structure", "verify plugin is correct", "validate plugin.json", "check plugin files", or mentions plugin validation. Also trigger proactively after user creates or modifies plugin components. Examples: | |
| 4 | 5 | |
| 5 | -<example> | |
| 6 | -Context: User finished creating a new plugin | |
| 7 | -user: "I've created my first plugin with commands and hooks" | |
| 8 | -assistant: "Great! Let me validate the plugin structure." | |
| 9 | -<commentary> | |
| 10 | -Plugin created, proactively validate to catch issues early. | |
| 11 | -</commentary> | |
| 12 | -assistant: "I'll use the plugin-validator agent to check the plugin." | |
| 13 | -</example> | |
| 6 | + <example> | |
| 7 | + Context: User finished creating a new plugin | |
| 8 | + user: "I've created my first plugin with commands and hooks" | |
| 9 | + assistant: "Great! Let me validate the plugin structure." | |
| 10 | + <commentary> | |
| 11 | + Plugin created, proactively validate to catch issues early. | |
| 12 | + </commentary> | |
| 13 | + assistant: "I'll use the plugin-validator agent to check the plugin." | |
| 14 | + </example> | |
| 14 | 15 | |
| 15 | -<example> | |
| 16 | -Context: User explicitly requests validation | |
| 17 | -user: "Validate my plugin before I publish it" | |
| 18 | -assistant: "I'll use the plugin-validator agent to perform comprehensive validation." | |
| 19 | -<commentary> | |
| 20 | -Explicit validation request triggers the agent. | |
| 21 | -</commentary> | |
| 22 | -</example> | |
| 16 | + <example> | |
| 17 | + Context: User explicitly requests validation | |
| 18 | + user: "Validate my plugin before I publish it" | |
| 19 | + assistant: "I'll use the plugin-validator agent to perform comprehensive validation." | |
| 20 | + <commentary> | |
| 21 | + Explicit validation request triggers the agent. | |
| 22 | + </commentary> | |
| 23 | + </example> | |
| 23 | 24 | |
| 24 | -<example> | |
| 25 | -Context: User modified plugin.json | |
| 26 | -user: "I've updated the plugin manifest" | |
| 27 | -assistant: "Let me validate the changes." | |
| 28 | -<commentary> | |
| 29 | -Manifest modified, validate to ensure correctness. | |
| 30 | -</commentary> | |
| 31 | -assistant: "I'll use the plugin-validator agent to check the manifest." | |
| 32 | -</example> | |
| 25 | + <example> | |
| 26 | + Context: User modified plugin.json | |
| 27 | + user: "I've updated the plugin manifest" | |
| 28 | + assistant: "Let me validate the changes." | |
| 29 | + <commentary> | |
| 30 | + Manifest modified, validate to ensure correctness. | |
| 31 | + </commentary> | |
| 32 | + assistant: "I'll use the plugin-validator agent to check the manifest." | |
| 33 | + </example> | |
| 33 | 34 | |
| 34 | 35 | model: inherit |
| 35 | 36 | color: yellow |
| @@ -1,34 +1,35 @@ | ||
| 1 | 1 | --- |
| 2 | 2 | name: skill-reviewer |
| 3 | -description: Use this agent when the user has created or modified a skill and needs quality review, asks to "review my skill", "check skill quality", "improve skill description", or wants to ensure skill follows best practices. Trigger proactively after skill creation. Examples: | |
| 3 | +description: |- | |
| 4 | + Use this agent when the user has created or modified a skill and needs quality review, asks to "review my skill", "check skill quality", "improve skill description", or wants to ensure skill follows best practices. Trigger proactively after skill creation. Examples: | |
| 4 | 5 | |
| 5 | -<example> | |
| 6 | -Context: User just created a new skill | |
| 7 | -user: "I've created a PDF processing skill" | |
| 8 | -assistant: "Great! Let me review the skill quality." | |
| 9 | -<commentary> | |
| 10 | -Skill created, proactively trigger skill-reviewer to ensure it follows best practices. | |
| 11 | -</commentary> | |
| 12 | -assistant: "I'll use the skill-reviewer agent to review the skill." | |
| 13 | -</example> | |
| 6 | + <example> | |
| 7 | + Context: User just created a new skill | |
| 8 | + user: "I've created a PDF processing skill" | |
| 9 | + assistant: "Great! Let me review the skill quality." | |
| 10 | + <commentary> | |
| 11 | + Skill created, proactively trigger skill-reviewer to ensure it follows best practices. | |
| 12 | + </commentary> | |
| 13 | + assistant: "I'll use the skill-reviewer agent to review the skill." | |
| 14 | + </example> | |
| 14 | 15 | |
| 15 | -<example> | |
| 16 | -Context: User requests skill review | |
| 17 | -user: "Review my skill and tell me how to improve it" | |
| 18 | -assistant: "I'll use the skill-reviewer agent to analyze the skill quality." | |
| 19 | -<commentary> | |
| 20 | -Explicit skill review request triggers the agent. | |
| 21 | -</commentary> | |
| 22 | -</example> | |
| 16 | + <example> | |
| 17 | + Context: User requests skill review | |
| 18 | + user: "Review my skill and tell me how to improve it" | |
| 19 | + assistant: "I'll use the skill-reviewer agent to analyze the skill quality." | |
| 20 | + <commentary> | |
| 21 | + Explicit skill review request triggers the agent. | |
| 22 | + </commentary> | |
| 23 | + </example> | |
| 23 | 24 | |
| 24 | -<example> | |
| 25 | -Context: User modified skill description | |
| 26 | -user: "I updated the skill description, does it look good?" | |
| 27 | -assistant: "I'll use the skill-reviewer agent to review the changes." | |
| 28 | -<commentary> | |
| 29 | -Skill description modified, review for triggering effectiveness. | |
| 30 | -</commentary> | |
| 31 | -</example> | |
| 25 | + <example> | |
| 26 | + Context: User modified skill description | |
| 27 | + user: "I updated the skill description, does it look good?" | |
| 28 | + assistant: "I'll use the skill-reviewer agent to review the changes." | |
| 29 | + <commentary> | |
| 30 | + Skill description modified, review for triggering effectiveness. | |
| 31 | + </commentary> | |
| 32 | + </example> | |
| 32 | 33 | |
| 33 | 34 | model: inherit |
| 34 | 35 | color: cyan |