Agent skill

Create Subagent

by majiayu000 in majiayu000/claude-skill-registry

Create custom subagents for specialized AI tasks. An agent skill from majiayu000/claude-skill-registry.

MITAuto-check passedAgent Workflows

Install Create Subagent

skills CLI
$ npx skills add majiayu000/claude-skill-registry --skill create-subagent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install majiayu000/claude-skill-registry create-subagent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent/create-subagent-darthlinuxer-agentic-skills .claude/skills/create-subagent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
create-subagent
GitHub stars
666
Used in
1 other repo
Token cost
~1.7k tokens
SKILL.md length
397 words
Files
2
Skills in repo
1,273
Repo updated
First seen
Licence
MIT

At a glance

Create custom subagents for specialized AI tasks. An agent skill from majiayu000/claude-skill-registry.

  • Works in 5 steps: Decide the Scope → Create the File → Define Configuration → …
  • The user wants to create a new type of subagent
  • SKILL.md covers When to Use Subagents, Subagent Locations, Subagent File Format and Writing Effective Descriptions, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Create Subagent is an agent skill from majiayu000/claude-skill-registry. Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`).

It sits in Agent Workflows, covering Subagents and Code review. The repository describes itself as: Searchable Claude Code skills catalog with source-linked guides and generated registry artifacts. The licence is MIT.

When your agent uses it

  • The user wants to create a new type of subagent
  • Set up task-specific agents
  • Configure code reviewers
  • Domain-specific assistants with custom prompts

Example prompts

  • “/create-subagent”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Decide the Scope
  2. Create the File
  3. Define Configuration
  4. Write the System Prompt
  5. Test the Agent

What it can do on your machine

Read from SKILL.md and the folder at commit 2d14a69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown, yaml and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Create Subagent loads about 1.7k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 397 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 2d14a69, republished under its MIT licence (© majiayu000). 397 words, ~1,653 tokens.

Download SKILL.mdSave it as .claude/skills/create-subagent/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
create-subagent
description
Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.

Creating Custom Subagents

This skill guides you through creating custom subagents for this platform. Subagents are specialized AI assistants that run in isolated contexts with custom system prompts.

When to Use Subagents

Subagents help you:

  • Preserve context by isolating exploration from your main conversation
  • Specialize behavior with focused system prompts for specific domains
  • Reuse configurations across projects with user-level subagents
Inferring from Context

If you have previous conversation context, infer the subagent's purpose and behavior from what was discussed. Create the subagent based on specialized tasks or workflows that emerged in the conversation.

Subagent Locations

LocationScopePriority
Workspace agents directoryCurrent projectHigher
User agents directoryAll your projectsLower

When multiple subagents share the same name, the higher-priority location wins.

Project subagents (workspace-level): Ideal for codebase-specific agents. Check into version control to share with your team.

User subagents (user-level): Personal agents available across all your projects.

Subagent File Format

Create a .md file with YAML frontmatter and a markdown body (the system prompt):

markdown
---
name: code-reviewer
description: Reviews code for quality and best practices
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
Required Fields
FieldDescription
nameUnique identifier (lowercase letters and hyphens only)
descriptionWhen to delegate to this subagent (be specific!)

Writing Effective Descriptions

The description is critical - the AI uses it to decide when to delegate.

yaml

# ❌ Too vague
description: Helps with code

# ✅ Specific and actionable
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.

Include "use proactively" to encourage automatic delegation.

Example Subagents

Code Reviewer
markdown
---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
---

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)

Include specific examples of how to fix issues.
Debugger
markdown
---
name: debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
---

You are an expert debugger specializing in root cause analysis.

When invoked:
1. Capture error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify solution works

Debugging process:
- Analyze error messages and logs
- Check recent code changes
- Form and test hypotheses
- Add strategic debug logging
- Inspect variable states

For each issue, provide:
- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach
- Prevention recommendations

Focus on fixing the underlying issue, not the symptoms.
Data Scientist
markdown
---
name: data-scientist
description: Data analysis expert for SQL queries, BigQuery operations, and data insights. Use proactively for data analysis tasks and queries.
---

You are a data scientist specializing in SQL and BigQuery analysis.

When invoked:
1. Understand the data analysis requirement
2. Write efficient SQL queries
3. Use BigQuery command line tools (bq) when appropriate
4. Analyze and summarize results
5. Present findings clearly

Key practices:
- Write optimized SQL queries with proper filters
- Use appropriate aggregations and joins
- Include comments explaining complex logic
- Format results for readability
- Provide data-driven recommendations

For each analysis:
- Explain the query approach
- Document any assumptions
- Highlight key findings
- Suggest next steps based on data

Always ensure queries are efficient and cost-effective.

Subagent Creation Workflow

Step 1: Decide the Scope
  • Project-level (workspace agents directory): For codebase-specific agents shared with team
  • User-level (user agents directory): For personal agents across all projects
Show full SKILL.md (153 more words)Show less
Step 2: Create the File

This repo uses platform-specific agents directories. For Agent, project agents live in .agent/agents/.

bash
# For project-level (Agent)
mkdir -p .agent/agents
touch .agent/agents/my-agent.md

# For user-level (platform-specific; e.g. ~/.agent/agents if supported)
mkdir -p ~/.agent/agents
touch ~/.agent/agents/my-agent.md
Step 3: Define Configuration

Write the frontmatter with the required fields (name and description).

Step 4: Write the System Prompt

The body becomes the system prompt. Be specific about:

  • What the agent should do when invoked
  • The workflow or process to follow
  • Output format and structure
  • Any constraints or guidelines
Step 5: Test the Agent

Ask the AI to use your new agent:

Use the my-agent subagent to [task description]

Best Practices

  1. Design focused subagents: Each should excel at one specific task
  2. Write detailed descriptions: Include trigger terms so the AI knows when to delegate
  3. Check into version control: Share project subagents with your team
  4. Use proactive language: Include "use proactively" in descriptions

Troubleshooting

Subagent Not Found
  • Ensure file is in the agents directory (workspace or user-level)
  • Check file has .md extension
  • Verify YAML frontmatter syntax is valid

© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/agent/create-subagent-darthlinuxer-agentic-skills of majiayu000/claude-skill-registry.

  • SKILL.md
  • metadata.json

Open the folder on GitHubat commit 2d14a69

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Create Subagent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Create Subagent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Subagent this skillmajiayu000/claude-skill-registry6661 repos~1.7kAutomated safety check: PassMIT
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT
Elvesaigorahub/elves222—~16kAutomated safety check: NotesMIT
Loop Change Verifiercobusgreyling/loop-engineering11k1 repos~383Automated safety check: PassMIT
Subagent-Driven DevelopmentHoangNguyen0403/agent-skills-standard571—~1.3kAutomated safety check: PassMIT

Similar skills

  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Elves

    aigorahub/elves

    Autonomous multi-batch development agent for long unattended runs, reviewed-PR landing, Cobbler-first orchestration, and optional Fugu, Manus, Grok, Devin, or Oh My Pi (omp) provider shortcuts.

    222 GitHub stars~16k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: notes
  • Loop Change Verifier

    cobusgreyling/loop-engineering

    Acts as a skeptical checker for changes an implementer sub-agent made, running the tests, confirming the diff scope and returning approve, reject or escalate to a human.

    11k GitHub starsUsed in 1 repo~383 tokens
    Agent WorkflowsAuto-check passed
  • Subagent-Driven Development

    HoangNguyen0403/agent-skills-standard

    Runs a multi-task implementation plan by sending each task to a fresh implementer subagent, reviewing it independently, then reviewing the whole branch.

    571 GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Recursive Subagent

    try-works/recursive-mode

    A skill your agent uses when recursive-mode work may benefit from delegated audit, review, or bounded implementation support.

    136 GitHub stars~3k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

More from majiayu000/claude-skill-registry

All 1,273 skills in this repo
  • Deep Research

    majiayu000/claude-skill-registry

    Multi-source deep research using firecrawl and exa MCPs. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 6 repos~1.1k tokens
    Auto-check passed
  • Exa Search

    majiayu000/claude-skill-registry

    Neural search via Exa MCP for web, code, and company research.

    666 GitHub starsUsed in 5 repos~856 tokens
    Auto-check passed
  • Fal AI Media

    majiayu000/claude-skill-registry

    Unified media generation via fal.ai MCP — image, video, and audio.

    666 GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed
  • Pyzotero

    majiayu000/claude-skill-registry

    Interact with Zotero reference management libraries using the pyzotero Python client.

    666 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check: notes
  • Bgpt Paper Search

    majiayu000/claude-skill-registry

    Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server.

    666 GitHub starsUsed in 4 repos~619 tokens
    Auto-check: notes
  • Bio Alignment Pairwise

    majiayu000/claude-skill-registry

    Perform pairwise sequence alignment using Biopython Bio.Align.PairwiseAligner.

    666 GitHub starsUsed in 4 repos~1.7k tokens
    Auto-check passed

Categories

Questions about Create Subagent

What does Create Subagent do?

Create custom subagents for specialized AI tasks. An agent skill from majiayu000/claude-skill-registry. Create Subagent is an agent skill from majiayu000/claude-skill-registry. Create custom subagents for specialized AI tasks.

When should I use Create Subagent?

Create Subagent fits situations like: the user wants to create a new type of subagent; set up task-specific agents; configure code reviewers; domain-specific assistants with custom prompts.

How do I install Create Subagent in Claude Code?

Run `npx skills add majiayu000/claude-skill-registry --skill create-subagent -a claude-code`. Or copy the skill folder (skills/agent/create-subagent-darthlinuxer-agentic-skills in majiayu000/claude-skill-registry) into .claude/skills/create-subagent in your project. Claude Code loads it when a task matches its description.

How do I install Create Subagent in Codex?

Run `npx skills add majiayu000/claude-skill-registry --skill create-subagent -a codex`. Or copy the skill folder (skills/agent/create-subagent-darthlinuxer-agentic-skills in majiayu000/claude-skill-registry) into .agents/skills/create-subagent in your project. Codex loads it when a task matches its description.

Can I use Create Subagent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/claude-skill-registry --skill create-subagent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-subagent, .gemini/skills/create-subagent, .github/skills/create-subagent and .opencode/skills/create-subagent in your project.

What does Create Subagent need to run?

SKILL.md names no scripts, command-line tools or credentials: Create Subagent is instructions for the agent only.

Does Create Subagent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Create Subagent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Create Subagent use?

Create Subagent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Create Subagent use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Create Subagent?

Skills that share tags, products or a category with Create Subagent: O2 Review Loop (openobserve/openobserve, 22k stars), Clawteam (win4r/ClawTeam-OpenClaw, 1.5k stars), Elves (aigorahub/elves, 222 stars) and Loop Change Verifier (cobusgreyling/loop-engineering, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create Subagent?

majiayu000 (a GitHub user) maintains it in majiayu000/claude-skill-registry, which has 666 GitHub stars. The repository holds 1,273 skills in this directory. The repository was last updated on October 7, 2026.

Source: majiayu000/claude-skill-registry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.