AGENT DEVELOPMENT / Anthropic
Agent Development for Claude Code Plugins
Explains how to write a Claude Code plugin agent file (frontmatter, trigger description, system prompt) and ships a Bash script that checks one agent file.
“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.”
01 / THE REASONING
Why this made the selection.
- It sets the agent frontmatter rules: a name of 3-50 lowercase letters, numbers and hyphens, a required description, model (inherit, sonnet, opus or haiku) and color, and an optional tools list it says to keep to the minimum needed.
- It ships scripts/validate-agent.sh, which checks an agent file for frontmatter markers, the four required fields, the name format and the system-prompt length, and it includes an agent-generation prompt it says was extracted from Claude Code.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/plugin-dev/skills/agent-development/SKILL.md
- plugins/plugin-dev/skills/agent-development/scripts/validate-agent.sh
- plugins/plugin-dev/README.md
- plugins/plugin-dev/LICENSE
- .claude-plugin/marketplace.json (plugin-dev entry)
- README.md
Our findings
- The SKILL.md frontmatter declares no allowed-tools. The skill is Markdown guidance plus one Bash validator.
- Validation limits in the SKILL.md: identifier 3-50 characters, description 10-5,000 characters, system prompt 20-10,000 characters.
- Manual creation ends with saving the file as agents/agent-name.md; all .md files in agents/ are auto-discovered.
- validate-agent.sh reads only the file named on its command line and prints its checks to the terminal. It has no network call and writes no file.
Not established by this review
- validate-agent.sh was not run against any agent file.
- references/agent-creation-system-prompt.md, references/system-prompt-design.md, references/triggering-examples.md and the two files in examples/ were not opened.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The plugin-dev README prints `/plugin install plugin-dev@claude-code-marketplace`. That line names a marketplace called claude-code-marketplace, which is not this repository's marketplace (.claude-plugin/marketplace.json names it claude-plugins-official), and it installs the whole plugin-dev plugin (seven skills, the /plugin-dev:create-plugin command and the plugin's three agents), not this skill alone, so install.command is null.
- For development the same README prints `cc --plugin-dir /path/to/plugin-dev`.
- The repository README gives the general form `/plugin install {plugin-name}@claude-plugins-official`, with the plugin name as a placeholder.
- This review ran none of these lines.
Before you start
- Claude Code, where the /plugin lines run
- Bash, for scripts/validate-agent.sh (#!/bin/bash)
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- agent-development SKILL.md ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/agent-development/SKILL.md
Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], limitations[1], limitations[2], limitations[3], compatibility, review.findings[0], review.findings[1], review.findings[2], access.permissions[0], access.permissions[1]
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/agent-development/scripts/validate-agent.sh
Supports: whySelected[1], bestFor[2], limitations[2], review.findings[3], access.permissions[2], install.prerequisites[1]
- plugin-dev README ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md
Supports: install.sourceUrl, install.steps[0], install.steps[1], install.prerequisites[0], limitations[4], limitations[5], compatibility
- plugin-dev LICENSE ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE
Supports: license, limitations[4], access.cost
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json
Supports: limitations[5], install.steps[0]
- Repository README ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md
Supports: install.steps[2]