← Explore all skills

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.

Upstream setup instructions ↗
  1. 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.
  2. For development the same README prints `cc --plugin-dir /path/to/plugin-dev`.
  3. The repository README gives the general form `/plugin install {plugin-name}@claude-plugins-official`, with the plugin name as a placeholder.
  4. 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.

  1. 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]

  2. 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]

  3. 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

  4. plugin-dev LICENSE ↗Checked

    https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE

    Supports: license, limitations[4], access.cost

  5. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json

    Supports: limitations[5], install.steps[0]

  6. Repository README ↗Checked

    https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md

    Supports: install.steps[2]

Evidence & Ask