К основному содержанию
скилл CX Codex

create-subagents — скилл для Claude Code: настройка и установка

Скилл create-subagents для Claude Code объясняет, как создавать субагентов, настраивать их инструменты и поручать им задачи через Task. Разделяет работу между агентами.

MIT ★ 1 988 обновлён 2026-04-01

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Открыть на GitHub

Что делает create-subagents

Скилл помогает настроить субагентов с отдельными ролями, инструкциями и доступом к инструментам, а затем организовать их работу через Task. Он разбирает поля конфигурации и структуру системного промпта: роль, ограничения, этапы работы и формат результата. Для инструкций рекомендуются XML-теги вместо заголовков Markdown.

Субагент работает в изолированном контексте и возвращает основной беседе итоговый ответ. Он не может задавать вопросы пользователю или ждать подтверждения, поэтому требования и решения нужно обсудить в основном чате заранее. Создать агента можно командой /agents, выбрав область проекта .claude/agents/ или пользователя ~/.claude/agents/; при совпадении имён проектный вариант имеет приоритет.

Какие задачи решает

  • создать субагента с узкой специализацией
  • ограничить набор инструментов агента
  • настроить автоматический выбор субагента по описанию
  • разделить исследование и генерацию кода между агентами

Примеры запросов агенту

  • Помоги создать субагента для проверки безопасности кода и задай ему нужные инструменты.
  • Настрой субагента в .claude/agents/, который исследует API и возвращает отчёт.
  • Объясни, как передать исследование и генерацию кода разным субагентам через Task.

Как установить create-subagents

1Через маркетплейс плагинов

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

Команда ставит плагин taches-cc-resources целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add glittercowboy/taches-cc-resources --skill create-subagents -a claude-code

3Вручную: положить файлы

~/.claude/skills/create-subagents/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/create-subagents/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о create-subagents

Как установить create-subagents в Claude Code?

Выполните команды по порядку: /plugin marketplace add glittercowboy/taches-cc-resources, затем /plugin install taches-cc-resources@taches-cc-resources.

Что делает скилл create-subagents?

Он объясняет, как задавать роли и системные инструкции субагентам Claude Code, выбирать доступные инструменты и выстраивать работу через Task.

Может ли субагент задавать вопросы пользователю?

Нет. Субагент работает без взаимодействия с пользователем и передаёт основной беседе только итоговый ответ. Требования и подтверждения следует получать в основном чате.

Исходный текст

SKILL.md · MIT
---
name: create-subagents
description: Expert guidance for creating, building, and using Claude Code subagents and the Task tool. Use when working with subagents, setting up agent configurations, understanding how agents work, or using the Task tool to launch specialized agents.
---

<objective>
Subagents are specialized Claude instances that run in isolated contexts with focused roles and limited tool access. This skill teaches you how to create effective subagents, write strong system prompts, configure tool access, and orchestrate multi-agent workflows using the Task tool.

Subagents enable delegation of complex tasks to specialized agents that operate autonomously without user interaction, returning their final output to the main conversation.
</objective>

<quick_start>
<workflow>
1. Run `/agents` command
2. Select "Create New Agent"
3. Choose project-level (`.claude/agents/`) or user-level (`~/.claude/agents/`)
4. Define the subagent:
   - **name**: lowercase-with-hyphens
   - **description**: When should this subagent be used?
   - **tools**: Optional comma-separated list (inherits all if omitted)
   - **model**: Optional (`sonnet`, `opus`, `haiku`, or `inherit`)
5. Write the system prompt (the subagent's instructions)
</workflow>

<example>
```markdown
---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes to review for quality, security, and best practices.
tools: Read, Grep, Glob, Bash
model: sonnet
---

<role>
You are a senior code reviewer focused on quality, security, and best practices.
</role>

<focus_areas>
- Code quality and maintainability
- Security vulnerabilities
- Performance issues
- Best practices adherence
</focus_areas>

<output_format>
Provide specific, actionable feedback with file:line references.
</output_format>
```
</example>
</quick_start>

<file_structure>
| Type | Location | Scope | Priority |
|------|----------|-------|----------|
| **Project** | `.claude/agents/` | Current project only | Highest |
| **User** | `~/.claude/agents/` | All projects | Lower |
| **Plugin** | Plugin's `agents/` dir | All projects | Lowest |

Project-level subagents override user-level when names conflict.
</file_structure>

<configuration>
<field name="name">
- Lowercase letters and hyphens only
- Must be unique
</field>

<field name="description">
- Natural language description of purpose
- Include when Claude should invoke this subagent
- Used for automatic subagent selection
</field>

<field name="tools">
- Comma-separated list: `Read, Write, Edit, Bash, Grep`
- If omitted: inherits all tools from main thread
- Use `/agents` interface to see all available tools
</field>

<field name="model">
- `sonnet`, `opus`, `haiku`, or `inherit`
- `inherit`: uses same model as main conversation
- If omitted: defaults to configured subagent model (usually sonnet)
</field>
</configuration>

<execution_model>
<critical_constraint>
**Subagents are black boxes that cannot interact with users.**

Subagents run in isolated contexts and return their final output to the main conversation. They:
- ✅ Can use tools like Read, Write, Edit, Bash, Grep, Glob
- ✅ Can access MCP servers and other non-interactive tools
- ❌ **Cannot use AskUserQuestion** or any tool requiring user interaction
- ❌ **Cannot present options or wait for user input**
- ❌ **User never sees subagent's intermediate steps**

The main conversation sees only the subagent's final report/output.
</critical_constraint>

<workflow_design>
**Designing workflows with subagents:**

Use **main chat** for:
- Gathering requirements from user (AskUserQuestion)
- Presenting options or decisions to user
- Any task requiring user confirmation/input
- Work where user needs visibility into progress

Use **subagents** for:
- Research tasks (API documentation lookup, code analysis)
- Code generation based on pre-defined requirements
- Analysis and reporting (security review, test coverage)
- Context-heavy operations that don't need user interaction

**Example workflow pattern:**
```
Main Chat: Ask user for requirements (AskUserQuestion)
  ↓
Subagent: Research API and create documentation (no user interaction)
  ↓
Main Chat: Review research with user, confirm approach
  ↓
Subagent: Generate code based on confirmed plan
  ↓
Main Chat: Present results, handle testing/deployment
```
</workflow_design>
</execution_model>

<system_prompt_guidelines>
<principle name="be_specific">
Clearly define the subagent's role, capabilities, and constraints.
</principle>

<principle name="use_pure_xml_structure">
Structure the system prompt with pure XML tags. Remove ALL markdown headings from the body.

```markdown
---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: sonnet
---

<role>
You are a senior code reviewer specializing in security.
</role>

<focus_areas>
- SQL injection vulnerabilities
- XSS attack vectors
- Authentication/authorization issues
- Sensitive data exposure
</focus_areas>

<workflow>
1. Read the modified files
2. Identify security risks
3. Provide specific remediation steps
4. Rate severity (Critical/High/Medium/Low)
</workflow>
```
</principle>

<principle name="task_specific">
Tailor instructions to the specific task domain. Don't create generic "helper" subagents.

❌ Bad: "You are a helpful assistant that helps with code"
✅ Good: "You are a React component refactoring specialist. Analyze components for hooks best practices, performance anti-patterns, and accessibility issues."
</principle>
</system_prompt_guidelines>

<subagent_xml_structure>
Subagent.md files are system prompts consumed only by Claude. Like skills and slash commands, they should use pure XML structure for optimal parsing and token efficiency.

<recommended_tags>
Common tags for subagent structure:

- `<role>` - Who the subagent is and what it does
- `<constraints>` - Hard rules (NEVER/MUST/ALWAYS)
- `<focus_areas>` - What to prioritize
- `<workflow>` - Step-by-step process
- `<output_format>` - How to structure deliverables
- `<success_criteria>` - Completion criteria
- `<validation>` - How to verify work
</recommended_tags>

<intelligence_rules>
**Simple subagents** (single focused task):
- Use role + constraints + workflow minimum
- Example: code-reviewer, test-runner

**Medium subagents** (multi-step process):
- Add workflow steps, output_format, success_criteria
- Example: api-researcher, documentation-generator

**Complex subagents** (research + generation + validation):
- Add all tags as appropriate including validation, examples
- Example: mcp-api-researcher, comprehensive-auditor
</intelligence_rules>

<critical_rule>
**Remove ALL markdown headings (##, ###) from subagent body.** Use semantic XML tags instead.

Keep markdown formatting WITHIN content (bold, italic, lists, code blocks, links).

For XML structure principles and token efficiency details, see @skills/create-agent-skills/references/use-xml-tags.md - the same principles apply to subagents.
</critical_rule>
</subagent_xml_structure>

<invocation>
<automatic>
Claude automatically selects subagents based on the `description` field when it matches the current task.
</automatic>

<explicit>
You can explicitly invoke a subagent:

```
> Use the code-reviewer subagent to check my recent changes
```

```
> Have the test-writer subagent create tests for the new API endpoints
```
</explicit>
</invocation>

<management>
<using_agents_command>
Run `/agents` for an interactive interface to:
- View all available subagents
- Create new subagents
- Edit existing subagents
- Delete custom subagents
</using_agents_command>

<manual_editing>
You can also edit subagent files directly:
- Project: `.claude/agents/subagent-name.md`
- User: `~/.claude/agents/subagent-name.md`
</manual_editing>
</management>

<reference>
**Core references**:

**Subagent usage and configuration**: [references/subagents.md](references/subagents.md)
- File format and configuration
- Model selection (Sonnet 4.5 + Haiku 4.5 orchestration)
- Tool security and least privilege
- Prompt caching optimization
- Complete examples

**Writing effective prompts**: [references/writing-subagent-prompts.md](references/writing-subagent-prompts.md)
- Core principles and XML structure
- Description field optimization for routing
- Extended thinking for complex reasoning
- Security constraints and strong modal verbs
- Success criteria definition

**Advanced topics**:

**Evaluation and testing**: [references/evaluation-and-testing.md](references/evaluation-and-testing.md)
- Evaluation metrics (task completion, tool correctness, robustness)
- Testing strategies (offline, simulation, online monitoring)
- Evaluation-driven development
- G-Eval for custom criteria

**Error handling and recovery**: [references/error-handling-and-recovery.md](references/error-handling-and-recovery.md)
- Common failure modes and causes
- Recovery strategies (graceful degradation, retry, circuit breakers)
- Structured communication and observability
- Anti-patterns to avoid

**Context management**: [references/context-management.md](references/context-management.md)
- Memory architecture (STM, LTM, working memory)
- Context strategies (summarization, sliding window, scratchpads)
- Managing long-running tasks
- Prompt caching interaction

**Orchestration patterns**: [references/orchestration-patterns.md](references/orchestration-patterns.md)
- Sequential, parallel, hierarchical, coordinator patterns
- Sonnet + Haiku orchestration for cost/performance
- Multi-agent coordination
- Pattern selection guidance

**Debugging and troubleshooting**: [references/debugging-agents.md](references/debugging-agents.md)
- Logging, tracing, and correlation IDs
- Common failure types (hallucinations, format errors, tool misuse)
- Diagnostic procedures
- Continuous monitoring
</reference>

<success_criteria>
A well-configured subagent has:

- Valid YAML frontmatter (name matches file, description includes triggers)
- Clear role definition in system prompt
- Appropriate tool restrictions (least privilege)
- XML-structured system prompt with role, approach, and constraints
- Description field optimized for automatic routing
- Successfully tested on representative tasks
- Model selection appropriate for task complexity (Sonnet for reasoning, Haiku for simple tasks)
</success_criteria>

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
csharp-async официальный github Скилл csharp-async для GitHub Copilot, который проверяет асинхронный код на C# и подсказывает, как привести его к принятым практикам. Включается при ревью и написании методов с Task и await. CX Codex +1 10 883установок groove-utilities-task-update andreadellacorte Скилл groove-utilities-task-update обновляет статус, описание и метаданные задачи в настроенном бэкенде. Подходит для прогресса и закрытия задач с обязательным итогом. CX Codex +1 546установок publish harbor-framework Скилл publish публикует задачи и датасеты Harbor в реестр. Проверяет авторизацию, идентификаторы задач и проводит через все шаги загрузки. CX Codex +1 202установок implement-with-subagents chrisbanes Скилл implement-with-subagents координирует выполнение графа задач соло-агентом или пулом субагентов с изолированными коммитами и обязательным независимым ревью. CX Codex +1 807установок setup-matt-pocock-skills Matt Pocock Скилл setup-matt-pocock-skills настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. CX Codex +1 1 052 851установок nested-subagents ruvnet Скилл nested-subagents для Claude Code строит дерево субагентов, где каждый ребёнок может породить своих детей. Разносит промежуточное состояние, не помещающееся в контекст одного агента. CX Codex +1 317установок

Из того же набора48

Весь набор →
create-mcp-servers Скилл create-mcp-servers помогает создавать MCP-серверы на Python и TypeScript для Claude Code и Claude Desktop с нуля или обновлять существующие. CX Codex +1 ★ 1 988звёзд репо slash-command-auditor Субагент slash-command-auditor аудирует .md-файлы слэш-команд Claude Code по структуре, аргументам, контексту, инструментам и безопасности. CX Codex ★ 1 988звёзд репо create-hooks Скилл create-hooks учит писать и настраивать хуки Claude Code: от блокировки опасных команд до автоформатирования после правок. CX Codex +1 ★ 1 988звёзд репо subagent-auditor Субагент subagent-auditor проверяет конфигурационные файлы субагентов Claude Code на соответствие лучшим практикам. Находит ошибки в структуре XML, лишние права инструментов и слабые описания ролей. CX Codex ★ 1 988звёзд репо debug-like-expert Скилл debug-like-expert активирует протокол методической отладки для сложных ошибок, когда стандартные методы не работают. Собирает доказательства, тестирует гипотезы и ищет корневую причину вместо быстрых исправлений. CX Codex +1 ★ 1 988звёзд репо skill-auditor Субагент skill-auditor проверяет файлы SKILL.md на соответствие стандартам Claude Code: валидирует чистую XML-разметку, длину описаний и структуру ссылок. CX Codex ★ 1 988звёзд репо create-slash-commands Скилл create-slash-commands для Claude Code — учит писать слэш-команды с YAML frontmatter и XML-тегами. Стандартизирует повторяющиеся операции. CX Codex +1 ★ 1 988звёзд репо create-prompt Команда create-prompt для создания готовых промптов, которые другой Claude сможет выполнить. Помогает структурировать задачу и сразу сохранить её в проект. CX Codex +1 ★ 1 988звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой