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

skillful-subagent-creator — скилл для Claude Code: установка

Скилл skillful-subagent-creator проектирует узкоспециализированных субагентов с готовыми скиллами для DAG-цепочек. Помогает составить четырёхсекционный промпт и связать входы с выходами.

MIT 147 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill skillful-subagent-creator -a claude-code
Открыть на GitHub

Что делает skillful-subagent-creator

Скилл формирует агентов узкого профиля, привязывая к каждому чёткий набор процедур. Он определяет границы роли, выбирает от двух до пяти ключевых скиллов и раскладывает их по уровням: базовые загружаются в контекст сразу, а редкие остаются в динамическом каталоге.

Промпт субагента строится ровно из четырёх блоков: роль с границами ответственности, правила применения скиллов, пошаговый цикл обработки задач и ограничения по качеству. Дополнительно скилл задаёт контракты входа и выхода в формате JSON, чтобы узлы оркестратора могли передавать файлы, статус проверки и список шагов без сбоев.

Инструмент не создаёт сами скиллы — для этого нужен отдельный скилл skill-architect. Если попытаться перегрузить субагента десятком встроенных скиллов, перерасход контекста быстро сделает его работу неэффективной, поэтому загружать напрямую стоит только базовые инструкции.

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

  • составить четырёхсекционный системный промпт для субагента
  • подобрать от 2 до 5 базовых скиллов под конкретную область
  • сформировать JSON-контракты входов и выходов для узлов оркестратора
  • разделить скиллы на прелоад в контекст и динамический каталог

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

  • Создай субагента для ревью пуллреквестов в React с навыками code-review-skill и testing-patterns
  • Спроектируй субагента-мигратора баз данных и подготовь для него четырёхсекционный промпт
  • Распиши входные и выходные контракты для агента синтеза исследований в графе задач

Как установить skillful-subagent-creator

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill skillful-subagent-creator -a claude-code

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

~/.claude/skills/skillful-subagent-creator/SKILL.md

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

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

Вопросы о skillful-subagent-creator

Как установить skillful-subagent-creator в Claude Code?

Выполните команду npx skills add curiositech/some_claude_skills --skill skillful-subagent-creator -a claude-code. Файл навыка будет сохранён по пути ~/.claude/skills/skillful-subagent-creator/SKILL.md.

Что делает skillful-subagent-creator?

Он проектирует субагентов для цепочек оркестрации DAG. Скилл помогает сформулировать роль, отобрать нужные инструменты и зафиксировать структуру промпта вместе с контрактами данных.

Можно ли создавать новые скиллы через этот инструмент?

Нет, он предназначен только для сборки субагентов и привязки готовых скиллов. Для написания самих файлов навыков используется skill-architect.

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

SKILL.md · MIT
---
name: skillful-subagent-creator
description: Creates Claude subagents equipped with curated skills for solving problems within DAG workflows. Use when designing a specialist subagent, selecting skills for a subagent, writing the 4-section
  subagent prompt, or wiring subagents into orchestration DAGs. Activate on "create subagent", "subagent with skills", "specialist agent", "agent DAG", "orchestrate agents", "skill-equipped agent". NOT
  for creating skills themselves (use skill-architect), general Claude Code usage, or single-agent prompting without skills.
allowed-tools: Read,Write,Edit,Grep,Glob
argument-hint: '[role-name] [domain] [skills-to-equip]'
metadata:
  category: Productivity & Meta
  tags:
  - skillful
  - subagent
  - creator
  - create-subagent
  - subagent-with-skills
  pairs-with:
  - skill: agent-creator
    reason: Subagent creation applies agent design patterns to specialized DAG workflow nodes
  - skill: task-decomposer
    reason: Decomposed tasks define the subagent specializations and skill requirements
  - skill: skill-architect
    reason: Subagent skill selection depends on understanding skill architecture and capabilities
---

# Skillful Subagent Creator

Creates Claude subagents that are equipped with curated skills as their standard operating procedures. Each subagent is "a specialist with a toolkit" — a narrow role, a small skill set, and a clear workflow for applying those skills.

---

## When to Use

✅ **Use for**:
- Designing a specialist subagent for a specific domain
- Selecting which skills to attach to a subagent (2-5 core skills)
- Writing the 4-section subagent prompt (Identity, Skills, Task Loop, Constraints)
- Wiring subagents into DAG orchestration workflows
- Defining input/output contracts between DAG nodes

❌ **NOT for**:
- Creating the skills themselves (use `skill-architect`)
- Single-agent prompting without skills
- General Claude Code features or MCP setup

---

## Subagent Creation Process

```mermaid
flowchart TD
  A[Define the role] --> B[Select 2-5 skills]
  B --> C[Write 4-section prompt]
  C --> D[Define input/output contracts]
  D --> E[Choose DAG position]
  E --> F{Standalone or chained?}
  F -->|Standalone| G[Test with sample task]
  F -->|Chained| H[Define handoff protocol]
  H --> G
  G --> I{Works correctly?}
  I -->|No| C
  I -->|Yes| J[Deploy]
```

---

## Step 1: Define the Role

A subagent's role must be **narrow enough to be expert, broad enough to be useful**.

```mermaid
flowchart TD
  A{How narrow?} -->|Too broad| B["Do all marketing" ❌]
  A -->|Right| C["Draft landing page copy" ✅]
  A -->|Too narrow| D["Fix typos in H1 tags" ❌]
```

**Test**: Can you describe what this subagent does in one sentence with a specific verb and noun? If not, narrow it.

**Examples of well-scoped roles**:

| Role | Domain | Sentence |
|------|--------|----------|
| Refactorer | TypeScript | "Designs and executes safe refactors in TypeScript monorepos" |
| PR Reviewer | Code review | "Reviews pull request diffs for correctness, style, and security" |
| Research Synthesizer | Research | "Synthesizes multi-source research into cited briefing documents" |
| Migration Planner | Databases | "Plans database schema migrations with rollback strategies" |

---

## Step 2: Select Skills (2-5)

Skills are the subagent's standard operating procedures. Too few and it improvises; too many and it drowns in context.

### Selection Criteria

```mermaid
flowchart TD
  A{For each candidate skill} --> B{Needed for >50% of tasks?}
  B -->|Yes| C[Preload into context]
  B -->|No| D{Needed for 10-50%?}
  D -->|Yes| E[Add to dynamic catalog]
  D -->|No| F[Don't include]
```

### Three Loading Tiers

| Tier | Skills | How Loaded | Token Cost |
|------|--------|------------|------------|
| **Preloaded** | 2-5 core skills | Full SKILL.md injected into system prompt | ~2-5k tokens per skill |
| **Catalog** | 5-20 available skills | Name + 1-line description in prompt; loaded on demand | ~50 tokens per skill |
| **None** | Everything else | Not mentioned; agent uses generic reasoning | 0 tokens |

### Example Skill Selection

**Role**: PR Reviewer for TypeScript/React

| Tier | Skill | Why |
|------|-------|-----|
| Preloaded | `code-review-skill` | Core to every task |
| Preloaded | `react-server-components` | Catches RSC anti-patterns |
| Catalog | `typescript-strict-mode` | Sometimes relevant |
| Catalog | `testing-patterns` | Only for test file reviews |
| None | `database-migration` | Not in scope |

---

## Step 3: Write the 4-Section Prompt

Every subagent prompt has exactly four sections. This structure ensures the subagent knows its role, its tools, its workflow, and its constraints.

### Section 1: Identity

```markdown
You are the **[Role Name]** subagent for this system.
You handle [narrow domain of tasks].
When a task is outside this scope, explicitly say so and
ask the orchestrator for a different agent.
```

Keep it to 2-4 sentences. Name the specific domain. State the boundary explicitly.

### Section 2: Skill Usage Rules

```markdown
You have access to the following skills, which define your methods:
- `skill-a`: [1-line purpose]
- `skill-b`: [1-line purpose]
- `skill-c`: [1-line purpose]

These are your standard operating procedures, not optional hints.
When tackling a task:
1. Decide which skill(s) apply
2. Follow their step-by-step workflow
3. Use their output formats and checklists
4. Reference skill steps by number as you work
```

### Section 3: Task-Handling Loop

```markdown
For each task you receive:
1. Restate the task in your own words
2. Select one or more skills that fit. If none fit well, say so.
3. If needed, ask 2-5 clarifying questions
4. Produce a short internal plan
5. Execute the skill workflow step by step
6. Run any validation/QA steps from the skill
7. Return:
   (a) Final artifacts
   (b) Which skills you used (and which steps)
   (c) Assumptions and remaining risks
```

### Section 4: Constraints

```markdown
Quality bar: [e.g., "Never knowingly leave tests failing"]
Safety: [e.g., "No destructive operations without confirmation"]
Tie-breaking: [e.g., "If speed vs robustness conflict, pick robustness"]
Output format: [e.g., "Always return valid JSON matching the output contract"]
```

---

## Step 4: Define Input/Output Contracts

Every subagent must have explicit contracts so orchestrators and downstream agents can work with it.

### Input Contract

```json
{
  "task": "string — description of what to do",
  "files": ["string — paths to relevant files"],
  "context": "string — prior agent output or user requirements",
  "constraints": {
    "time_budget": "string — e.g., '5 minutes'",
    "quality_bar": "string — e.g., 'production-ready'"
  }
}
```

### Output Contract

```json
{
  "status": "pass | warn | fail",
  "artifacts": ["string — files created or modified"],
  "summary": "string — 1-3 sentence description of what was done",
  "skills_used": ["string — skill names and step numbers"],
  "risks": ["string — remaining risks or assumptions"],
  "metadata": {
    "duration_ms": "number",
    "tokens_used": "number"
  }
}
```

---

## Step 5: Wire into DAG Workflows

### Orchestration Patterns

```mermaid
flowchart TD
  subgraph "Single Specialist"
    O1[Orchestrator] --> S1[Specialist]
    S1 --> O1
  end

  subgraph "Chain"
    O2[Orchestrator] --> C1[Designer]
    C1 --> C2[Implementer]
    C2 --> C3[Tester]
    C3 --> O2
  end

  subgraph "Fan-out / Fan-in"
    O3[Orchestrator] --> P1[Auth Agent]
    O3 --> P2[Billing Agent]
    O3 --> P3[UI Agent]
    P1 --> M[Merger]
    P2 --> M
    P3 --> M
    M --> O3
  end
```

### Pattern Selection

| Pattern | When to Use | Skill Requirement |
|---------|-------------|-------------------|
| **Single Specialist** | Task maps to one domain | Agent has 2-5 preloaded skills |
| **Chain** | Sequential transformation pipeline | Each agent has different skills; output of A feeds input of B |
| **Fan-out / Fan-in** | Independent parallel work | Agents work concurrently; merger resolves conflicts |
| **Loop** | Iterative refinement | Same agent re-runs with feedback until quality bar met |
| **Human-in-the-Loop** | Approval required | Agent produces draft; human reviews; agent revises |

### DAG Node Definition

Each node in a DAG is a subagent with:

```yaml
node:
  id: review-pr
  agent: pr-reviewer
  skills: [code-review-skill, react-server-components]
  input_from: [parse-diff]
  output_to: [merge-decision]
  retry: 2
  timeout: 300s
  on_failure: escalate-to-human
```

---

## Step 6: Test

### Test Protocol

1. **Happy path**: Give the subagent a task that matches its skills perfectly
2. **Edge case**: Give a task at the boundary of its scope
3. **Out of scope**: Give a task outside its domain — it should refuse and say so
4. **Skill coverage**: Verify it uses the attached skills, not ad-hoc reasoning
5. **Output contract**: Verify output matches the JSON schema exactly

### Red Flags

- Agent invents processes instead of following skills → Skill usage rules not strong enough
- Agent tries to handle out-of-scope tasks → Identity section not clear enough
- Output doesn't match contract → Add explicit output format to constraints
- Agent loads all references eagerly → Add lazy-loading instruction to prompt

---

## Complete Example: PR Reviewer Subagent

### Config

```yaml
name: pr-reviewer
role: "Reviews TypeScript/React pull requests for correctness, style, and security"
skills:
  preloaded:
    - code-review-skill
    - react-server-components
  catalog:
    - typescript-strict-mode
    - testing-patterns
tools: [Read, Grep, Glob]
input_from: [diff-parser]
output_to: [merge-decision]
```

### Prompt

```
You are the **PR Reviewer** subagent. You review TypeScript and React
pull request diffs for correctness, readability, performance, and security.
You do NOT implement features, fix bugs, or write new code. If asked to do
so, say "This is outside my scope — route to the Implementer agent."

Your skills define your standard process:
- `code-review-skill`: Structured review methodology (correctness → style → perf → security)
- `react-server-components`: Catches RSC anti-patterns ('use client' overuse, async component errors)

For each PR you receive:
1. Restate what the PR changes and why
2. Select applicable skills (always code-review-skill; add react-server-components if React files changed)
3. Follow the skill's review steps in order
4. Produce findings in the output contract format
5. Summarize: approve, request changes, or block

Quality bar: Never approve a PR with failing tests or security vulnerabilities.
Tie-breaking: If unsure whether something is a bug or style preference, flag it as "suggestion" not "required."
Output: Always return JSON matching the output contract schema.
```

---

## Anti-Patterns

### Skill-Less Subagent
**Wrong**: Creating a subagent with just a role description and no skills.
**Why**: It will improvise a new process every time instead of following a consistent methodology.
**Fix**: Attach 2-5 skills as standard operating procedures.

### Skill Overload
**Wrong**: Attaching 15 skills to one subagent.
**Why**: Blows context window; agent spends tokens selecting skills instead of executing.
**Fix**: Max 5 preloaded, rest in catalog. Let the orchestrator pre-filter.

### Missing Output Contract
**Wrong**: Subagent returns free-form text that downstream agents can't parse.
**Why**: DAG breaks because the next node can't consume the output.
**Fix**: Define explicit JSON output contract. Validate in tests.

### Scope Creep
**Wrong**: Subagent tries to handle everything instead of refusing out-of-scope tasks.
**Why**: Identity section doesn't state boundaries clearly enough.
**Fix**: Add "You do NOT handle X, Y, Z. If asked, say so and suggest the right agent."

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
subagent-creator tech-leads-club Скилл subagent-creator для Claude Code помогает описать субагента: файл с frontmatter, промпт, шаги и формат отчёта. Описывает субагента для задачи с отдельным контекстом. CX Codex +1 956установок cursor-subagent-creator tech-leads-club Скилл cursor-subagent-creator для Cursor помогает спроектировать субагента: выбрать место установки, настроить поля и описать шаги работы. Настраивает переиспользуемых субагентов для сложных задач с отдельным контекстом. CX Codex +1 ★ 7 191звёзд репо subagent-plan-dev sentimony Скилл subagent-plan-dev управляет выполнением готового плана разработки через связку субагентов. Помогает распределять задачи, независимо проверять код и возобновлять упавшие сессии. CX Codex +1 2 200установок audit-subagent Lex Christopherson Команда audit-subagent для Claude Code, которая запускает аудит конфигурации субагента: проверяет структуру XML, настройки, выбор инструментов и соответствие стандартам. Вызывается с путём к .md-файлу субагента. CX Codex +1 ★ 1 988звёзд репо subagent-auditor Lex Christopherson Субагент subagent-auditor проверяет конфигурационные файлы субагентов Claude Code на соответствие лучшим практикам. Находит ошибки в структуре XML, лишние права инструментов и слабые описания ролей. CX Codex ★ 1 988звёзд репо orchestration stablyai Скилл orchestration для Claude Code запускает задачи в отдельном воркере Orca и возвращает результаты. CX Codex +1 359 600установок

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

Весь набор →
typescript-advanced-patterns Скилл typescript-advanced-patterns помогает проектировать сложные типы TypeScript: от branded types и discriminated unions до Zod-инференса и exhaustive checking. CX Codex +1 148установок ml-system-design-interview Скилл ml-system-design-interview тренирует прохождение собеседований по ML System Design уровня L6+. Помогает уложить архитектуру рекомендаций или RAG в тайминг 45 минут. CX Codex +1 147установок monorepo-management Скилл monorepo-management помогает спроектировать workspace для JavaScript и TypeScript, настроить задачи Turborepo или Nx и разобраться с зависимостями пакетов. Пригодится при создании монорепозитория или переносе проекта. CX Codex +1 147установок skill-grader Скилл skill-grader для Claude Code оценивает Claude Agent Skills по 10 осям, выставляет оценки от A+ до F и предлагает улучшения. Для аудита одного скилла, сравнения нескольких или проверки библиотеки. CX Codex +1 147установок tech-presentation-interview Скилл tech-presentation-interview готовит к раунду «обратный system design», где вы презентуете свою прошлую техническую работу: выбор проекта, структура рассказа, глубина проработки, ответы на каверзные вопросы. CX Codex +1 146установок docker-containerization Скилл docker-containerization настраивает многоэтапные Dockerfile, ускоряет сборку через кэш слоёв и готовит конфиги docker-compose для локальной разработки. CX Codex +1 143установок cost-optimizer Скилл cost-optimizer следит за расходами на LLM при выполнении DAG и снижает уровень моделей или пропускает шаги, чтобы уложиться в бюджет. CX Codex +1 143установок git-workflow-expert Скилл git-workflow-expert для git-операций: стратегии ветвления, разрешение конфликтов, rebase и продвинутые команды вроде bisect и reflog. Выручает, когда история запуталась или нужно вытащить потерянный коммит. CX Codex +1 143установок

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

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