building-agents
Expert at creating and modifying Claude Code agents (subagents). Auto-invokes when the user wants to create, update, modify, enhance, validate, or standardize agents, or when modifying agent YAML frontmatter fields (especially 'model', 'tools', 'description'), needs help designing agent architecture, or wants to understand agent capabilities. Also auto-invokes proactively when Claude is about to write agent files (*/agents/*.md), create modular agent architectures, or implement tasks that involve creating agent components.
npx skills add majiayu000/claude-skill-registry --skill building-agents-c0ntr0lledcha0s-claude-code-plugin-a --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.
# Building Agents Skill You are an expert at creating Claude Code agents (subagents). Agents are specialized assistants that handle delegated tasks with independent context and dedicated resources. ## When to Create an Agent vs Other Components **Use an AGENT when:** - The task requires specialized, focused expertise - You need independent context and isolation from the main conversation - The task involves heavy computation or long-running operations - You want explicit invocation rather than automatic activation - The task benefits from dedicated tool permissions **Use a SKILL instead when:** - You want automatic, context-aware assistance - The expertise should be "always on" and auto-invoked - You need progressive disclosure of context **Use a COMMAND instead when:** - The user explicitly triggers a specific workflow - You need parameterized inputs via command arguments ## Agent Schema & Structure ### File Location - **Project-level**: `.claude/agents/agent-name.md` - **User-level**: `~/.claude/agents/agent-name.md` - **Plugin-level**: `plugin-dir/agents/agent-name.md` ### File Format Single Markdown file with YAML frontmatter and Markdown body. ### Required Fields ```yaml --- n
- When to Create an Agent vs Other Components
- Agent Schema & Structure
- File Location
- File Format
- Required Fields
- Optional Fields
- Subagent Architecture Constraints
- Naming Conventions
- Agent Body Content
- Template Structure
- Tool Selection Strategy
- Minimal Permissions (Recommended Start)
- File Modification
- System Operations
python3 {baseDir}/scripts/validate-agent.py <agent-file>
python3 validate-agent.py .claude/agents/code-reviewer.md
git add .claude/agents/my-agent.md
git commit -m "backup: agent before major update"
python3 {baseDir}/scripts/validate-agent.py my-agent.md # Verify validity
git commit -m "refactor(agent): improve my-agent security and docs"What does the building-agents skill do?
Expert at creating and modifying Claude Code agents (subagents). Auto-invokes when the user wants to create, update, modify, enhance, validate, or standardize agents, or when modifying agent YAML frontmatter fields (especially 'model', 'tools', 'description'), needs help designing agent architecture, or wants to understand agent capabilities. Also auto-invokes proactively when Claude is about to write agent files (*/agents/*.md), create modular agent architectures, or implement tasks that involve creating agent components.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill building-agents-c0ntr0lledcha0s-claude-code-plugin-a --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.