claude-subagent-development
This skill should be used when the user asks to "create a subagent", "validate a subagent", "generate subagent schema", "check subagent configuration", "write subagent specification", or mentions subagent development, validation, or protocol documentation for Claude Code.
npx skills add majiayu000/claude-skill-registry --skill claude-subagent-development-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Claude Code Subagent Development Comprehensive guidance for creating, validating, and documenting Claude Code subagents with schemas and protocol specifications. ## Purpose This skill provides structured workflows for developing production-ready Claude Code subagents. Use when creating new subagents, validating existing configurations, generating JSON schemas for validation, or writing technical specifications for subagent protocols. ## When to Use This skill should be used when: - Creating new subagent configurations - Validating subagent YAML frontmatter and structure - Generating JSON schemas for subagent validation - Writing protocol specifications and technical documentation - Reviewing subagent configurations for best practices - Debugging subagent loading or invocation issues ## Core Concepts ### Subagent Structure Subagents are Markdown files with YAML frontmatter: ```markdown --- name: subagent-identifier description: When and how to use this subagent tools: Tool1, Tool2 model: sonnet permissionMode: default skills: skill1, skill2 --- System prompt content in Markdown format. ``` ### Required Fields - **name**: Lowercase identifier with hyphens (pattern: `^[a-z0-9-]+$`)
- Purpose
- When to Use
- Core Concepts
- Subagent Structure
- Required Fields
- Optional Fields
- Workflows
- Create a New Subagent
- Validate Existing Subagent
- Generate JSON Schema
- Write Protocol Specification
- Tools and Resources
- Validation Script
- Creation Script
cp assets/template.md .claude/agents/your-subagent.md scripts/validate-subagent.sh .claude/agents/your-subagent.md scripts/validate-subagent.sh path/to/subagent.md scripts/validate-subagent.sh <subagent-file> scripts/create-subagent.sh <name> <scope> With ajv-cli ajv validate -s assets/subagent-schema.json -d your-subagent.json With Python jsonschema python -c "import json, jsonschema; \
What does the claude-subagent-development skill do?
This skill should be used when the user asks to "create a subagent", "validate a subagent", "generate subagent schema", "check subagent configuration", "write subagent specification", or mentions subagent development, validation, or protocol documentation for Claude Code.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill claude-subagent-development-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.