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

skill-studio — скилл для Claude Code: что делает и как установить

Скилл skill-studio проводит интервью по методике JTBD и анализирует прошлые сессии Claude Code, чтобы спроектировать спецификацию нового скилла или агента.

MIT 174 установок ★ 414 обновлён 2026-10-23

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

Что делает skill-studio

Скилл помогает сформулировать требования к новому сценарию автоматизации или субагенту через пошаговый опрос. В текстовом режиме диалог идёт прямо в терминале, а результатом становится файл design.md и графическая карта design.svg. Если уже накоплены сессии Claude Code, инструмент умеет разбирать их историю: находит цепочки вызовов инструментов, запуск субагентов и повторяющиеся шаги, превращая их в черновик спецификации.

Интерфейс опирается на внешнюю CLI-утилиту skill-studio, поэтому для запуска нужен Python 3.11+ и предварительная сборка через pip install -e . внутри папки скилла. Без установленного CLI инструмент работать не сможет.

Голосовой режим требует четыре ключа доступа: DAILY_API_KEY, GROQ_API_KEY, DEEPGRAM_API_KEY и ключ LLM-провайдера вроде OPENROUTER_API_KEY. Для обычного текстового интервью внешние ключи не понадобятся.

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

  • Спроектировать спецификацию нового агента через JTBD-интервью
  • Разобрать историю сессии Claude Code и извлечь повторяющиеся цепочки инструментов
  • Сгенерировать карту архитектуры в формате SVG и документ design.md
  • Выделить роли субагентов из логов предыдущей работы

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

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

Как установить skill-studio

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill skill-studio -a claude-code

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

~/.claude/skills/skill-studio/SKILL.md

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

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

Вопросы о skill-studio

Как установить skill-studio в Claude Code?

Выполните команду npx skills add glebis/claude-skills --skill skill-studio -a claude-code. Затем установите CLI-утилиту через pip install -e . в папке скилла, используя Python 3.11+.

Что делает skill-studio?

Скилл проводит опрос по методике JTBD для проектирования автоматизаций, формирует спецификацию design.md со схемой design.svg, а также извлекает шаблоны работы и вызовы инструментов из логов Claude Code.

Какие API-ключи нужны для работы?

В обычном текстовом режиме внешние ключи не требуются. Голосовой опрос запросит DAILY_API_KEY, GROQ_API_KEY, DEEPGRAM_API_KEY и ключ модели, например OPENROUTER_API_KEY.

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

SKILL.md · MIT
---
name: skill-studio
description: Interview-driven automation design tool. This skill should be used when the user wants to design a new skill, agent, automation, shortcut, or any other automatable workflow. Runs a coverage-driven JTBD interview (text or voice), then exports a one-page markdown spec plus an SVG design map. Can also analyze Claude Code sessions (current or by ID) to extract workflows, subagent patterns, and skill usage, then propose new skills based on observed patterns. Use this skill whenever the user mentions analyzing a session, extracting workflows, proposing skills from past work, reviewing what tools or agents were used, or turning a session into a skill. Triggers on "analyze this session", "what skills could I build from this", "propose skills from session", "what workflows did I use", "what did I do in this session", "extract patterns", "turn this into a skill".
---

# Skill Studio

## Purpose

Conduct a structured JTBD interview that captures what to build, for whom, and why — then emit a one-page `design.md` + `design.svg` spec. Sits between "should I automate this?" (automation-advisor) and "how do I package this as a skill?" (skill-creator).

## Architecture

This skill wraps an external CLI tool (`skill-studio`) installed via pip. The CLI handles session state, coverage tracking, and export. The skill orchestrates the CLI — it does not bundle scripts directly.

## When to use

Trigger on any of: "help me design...", "build a skill for...", "design an automation for...", "I want a bot/agent/workflow that...", "scope a new shortcut". Also trigger when the user describes a recurring pain and asks how to automate it.

Also trigger for session analysis: "analyze this session", "what skills could I build from this", "propose skills from session", "what workflows did I use", "what did I do in this session", "extract patterns from my work", "turn this session into a skill", "what could be automated from this". If the user references a session ID or asks about subagent activity, this skill handles it.

## Prerequisites

- `skill-studio` CLI on PATH (`pip install -e .` inside the skill directory, or `skill-studio init` for guided setup)
- Python 3.11+
- Text mode needs no API key — the interview runs natively inside Claude Code
- Voice mode (`--voice`) needs `DAILY_API_KEY`, `GROQ_API_KEY`, `DEEPGRAM_API_KEY`, and an LLM provider key (`OPENROUTER_API_KEY` by default). If any key is missing, suggest text mode instead.

To verify the CLI is available, run `skill-studio --help`. If the command is not found, install it from the skill's base directory: `pip install -e <skill-studio-base-dir>`.

## Interview protocol (text mode)

Follow these steps in order.

### Step 0 — (Optional) Seed from a prior session

If the user provides a prior session (Claude Code transcript, another skill-studio session, or arbitrary transcript path), seed the interview instead of starting blank:

```bash
# Analyze the current running session
skill-studio propose-from-session --current

# Analyze a specific session by ID (prefix match works)
skill-studio propose-from-session <session_id>

# Analyze a session from a specific project
skill-studio propose-from-session <session_id> --project <project-dir-name>

# Analyze an arbitrary transcript file
skill-studio propose-from-session --path <file>

# Inspect the raw extracted bundle without an LLM call
skill-studio propose-from-session --current --bundle-only
```

This runs in two stages:
1. **Deterministic ingest** (no LLM) — extracts models tried, cost events, prompt changes, pain snippets, **subagent calls** (Agent tool with descriptions, types, prompt snippets), **skill invocations**, **tool sequences** (ordered list of all tool calls), **tool frequency**, and **workflow patterns** (repeated multi-tool sequences). A 50k-token transcript compresses to a compact structured JSON bundle.
2. **Single LLM call** — over that compact bundle only, proposes a partial DesignJSON patch with a `rationale` map citing which signals justified each field, plus **skill proposals** — potential new skills derived from observed workflow patterns and agent orchestration.

The bundle includes these structured signals:
- `agents` — subagent calls with `description`, `subagent_type`, and `prompt_snippet`
- `skills` — skill invocations observed during the session
- `tool_sequence` — ordered list of all tool calls with descriptions
- `tool_frequency` — how often each tool was used
- `workflow_patterns` — repeated tool sequences (e.g. "Read → Edit → Bash" appearing 3× suggests a test-fix cycle)

**The proposal is NOT applied automatically.** Present it to the user (with the rationale and any skill proposals) and ask for approval. Offer: `approve as-is`, `edit inline`, `discard and start fresh`, `approve partial` (keep some fields, re-interview others).

If the proposal includes `skill_proposals`, present them separately and ask if the user wants to proceed to `/skill-creator` with any of them.

`propose-from-session` does not create a session. After approval, run `new-session` (Step 1) to create one, then pipe the approved patch to `apply-patch`, and continue the interview loop from the next uncovered target.

### Browsing Claude Code sessions

To help the user pick a session to analyze:

```bash
# List recent sessions (most recent first, all projects)
skill-studio list-sessions

# Filter to a specific project
skill-studio list-sessions --project <project-dir-name>

# Show more results
skill-studio list-sessions --limit 50
```

Output shows session ID prefix, age, size, and title.

### Step 1 — Start the session

Presets: `ai-agent` (default), `life-automation`, `knowledge-work`, `custom`.
Depth: `sprint` (0.60, ~5–7 questions), `standard` (0.80, ~15–20 questions, default), `deep` (0.92, ~25–35 questions).

Styles (shape how questions are phrased):
- `scenario-first` (default) — "Walk me through a specific time when..."
- `socratic` — "Why does that matter? What would happen if...?"
- `metaphor-first` — "If this automation were a [thing], what would it be?"
- `form` — One direct question per field, no preamble.

Run:

```bash
skill-studio new-session --preset <preset> --depth <depth> --style <style>
```

Output:

```
session_id: <uuid>
opening: <question text>
```

Store the `session_id`. Present the opening question to the user as a direct text message.

### Step 2 — Interview loop

For every user answer:

**a. Extract a JSON patch.** Emit a JSON object containing only the DesignJSON fields the answer addresses. Use only fields from the schema below — never hallucinate fields or values. If nothing schema-relevant was said, emit `{}`.

Example patch:

```json
{"jtbd.situation": "When I finish a coaching call and need to write up notes", "problem.what_hurts": "Manual note-taking takes 20 minutes and I lose details"}
```

Example with list fields:

```json
{"needs.functional": ["transcribe audio", "extract action items"], "guardrails": ["never send notes without review"]}
```

Example with object-list field (`scenarios`):

```json
{"scenarios": [{"title": "Post-coaching rush", "vignette": "Call ends at 14:00, next meeting at 14:15 — I scribble three bullet points and lose the rest by evening."}]}
```

**DesignJSON fields:**

| Field | Type | Notes |
|-------|------|-------|
| `hook` | str | One-sentence pitch of the automation |
| `problem.what_hurts` | str | Specific pain |
| `problem.cost_today` | str | What the pain costs right now |
| `needs.functional` | list[str] | What it must do |
| `needs.emotional` | list[str] | How the user wants to feel |
| `needs.social` | list[str] | Relational / status needs |
| `jtbd.situation` | str | When this happens |
| `jtbd.motivation` | str | What the user wants |
| `jtbd.outcome` | str | So they can... |
| `before_after.before_external` | str | Visible state before |
| `before_after.before_internal` | str | Felt state before |
| `before_after.after_external` | str | Visible state after |
| `before_after.after_internal` | str | Felt state after |
| `scenarios` | list[{title, vignette}] | Concrete day-in-the-life stories |
| `trigger.type` | `manual` / `scheduled` / `event` | |
| `trigger.detail` | str | e.g. "7:45am weekdays" |
| `inputs` | list[str] | Data / services consumed |
| `capabilities` | list[str] | What it does |
| `outputs` | list[str] | What it produces |
| `guardrails` | list[str] | Safety rails; negative-space rules |
| `cta` | str | Next action at end of design |
| `concept_imagery.metaphor` | str | Visual / verbal handle |

**b. Apply the patch.**

```bash
echo '<patch_json>' | skill-studio apply-patch <session_id>
```

Output:

```
coverage: 0.42
next_target: jtbd.situation
```

**c. Check stop conditions.** End the loop if either:
- `coverage >= threshold` (sprint=0.60, standard=0.80, deep=0.92)
- User says "done", "wrap up", or "stop"

**d. Ask the next question.** Target the `next_target` field, in the active style. Never re-ask a field already past 0.5 coverage. Present the question as direct text to the user.

### Step 3 — Export

```bash
skill-studio done <session_id>
```

Prints the paths to `design.md` and `design.svg`. Present both paths to the user.

## Voice mode

For voice interviews, skip the manual loop and delegate to the built-in pipeline:

```bash
skill-studio new --voice --preset <preset> --depth <depth>
```

This spins up a Daily room (auto-opens in the browser), runs Groq Whisper STT -> interview loop -> Deepgram TTS, and auto-exports on session end.

If voice mode fails due to missing API keys, fall back to text mode and inform the user. To configure keys, run `skill-studio init`.

## Other commands

- `skill-studio list` — list all skill-studio interview sessions
- `skill-studio list-sessions` — list Claude Code sessions (most recent first)
- `skill-studio list-sessions --project <name>` — filter by project
- `skill-studio export <id> md-svg` — regenerate `design.md` + `design.svg`
- `skill-studio coverage <id>` — per-field confidence JSON
- `skill-studio next-target <id>` — ask-this-next hint
- `skill-studio init` — full first-run wizard (prereq checks + keys + paths)
- `skill-studio setup` — narrower key-rotation flow (sops-only)

## Sessions

Each interview writes to `$SKILL_STUDIO_HOME/sessions/<uuid>/` (default: `~/.skill-studio/sessions/<uuid>/`):

- `design.json` — canonical schema (single source of truth)
- `transcript.md` — full Q&A log
- `design.md`, `design.svg` — exported artifacts

## Troubleshooting

- **`skill-studio: command not found`** — Run `pip install -e <skill-studio-base-dir>` and retry.
- **`apply-patch` returns an error** — Verify the JSON patch is valid (keys must match schema fields above). Run `skill-studio coverage <session_id>` to inspect current state.
- **Session not found** — Always run `new-session` before the first `apply-patch`. There is no implicit session creation. Run `skill-studio list` to check existing sessions.
- **Voice mode key errors** — Run `skill-studio init` to configure missing keys, or fall back to text mode.

## Notes

- The interview loop runs entirely inside Claude Code for text mode. No Anthropic API key is required.
- Voice mode LLM provider is swappable via `LLM_PROVIDER=anthropic` (default is `openrouter`).

© glebis · MIT · glebis/claude-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
cli-anything-obs-studio HKUDS Скилл cli-anything-obs-studio помогает агенту редактировать JSON-коллекции сцен OBS Studio через CLI: создавать сцены, источники, фильтры и параметры вывода. CX Codex +1 600установок ipollowork-video-studio Devin-AXIS Скилл ipollowork-video-studio маршрутизирует задачи по созданию видео в iPolloWork: определяет этап работы и подключает нужный узкий скилл для сценария, сборки, озвучки или саундтрека. CX Codex +1 ★ 7 523звёзд репо cli-anything-eez-studio HKUDS Даёт им CLI-доступ к EEZ Studio: читать и менять .eez-project-файлы, добавлять LVGL-виджеты, управлять SCPI-командами. Работает через cli-anything-eez-studio с флагом --json. CX Codex +1 266установок Power Automate MCP Server by Flow Studio ninihen1 Power Automate MCP Server by Flow Studio — MCP-сервер для Claude Code и Codex, показывающий входы и выходы действий и итерации циклов для диагностики падений потоков. CX Codex +1 ★ 34звёзд репо studio-producer Michael Galpert Субагент studio-producer для координации нескольких команд, распределения ресурсов и оптимизации процессов в 6-дневных циклах разработки. ★ 1 013звёзд репо studio-coach Michael Galpert Плагин studio-coach координирует субагентов во время сложных задач, помогает при затыках в работе и настраивает команду перед спринтами. ★ 1 013звёзд репо

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

Весь набор →
jtbd Скилл jtbd перенаправляет рабочие процессы Jobs to be Done в плагин humane-agentic-design. CX Codex +1 185установок recording Включается по /recording, скрывает имена, даты, деньги и другую личную информацию в реальном времени, пока вы ведёте запись или показываете экран. CX Codex +1 184установок lab-retro Скилл lab-retro проводит участника Claude Code Lab через самооценку, оформление полезного промпта, план на месяц и отзыв организатору. Запускайте после обучения или по частям. CX Codex +1 182установок vision-bench Скилл vision-bench сравнивает изображения и выставляет оценки через vision LLM по YAML-критериям. Запускается для генерации отчётов, OCR, анализа графиков и проверки стиля. CX Codex +1 178установок linear Скилл управляет задачами и проектами Linear через CLI. Попросите создать задачу, найти её в бэклоге или изменить статус. CX Codex +1 170установок session-finder Скилл session-finder индексирует сессии Claude Code эмбеддингами Gemini и находит нужную по описанию задачи, а потом открывает её или предлагает claude --resume. CX Codex +1 166установок timebuzzer-led Скилл timebuzzer-led для управления RGB LED на аппаратном устройстве timeBuzzer по протоколу MIDI. Задаёт цвет, эффекты (пульс, стробоскоп, радуга, затухание) и статус-сигналы прямо из кода. CX Codex +1 165установок session-anonymizer Скилл session-anonymizer удаляет персональные данные из заметок и транскриптов терапевтических или коучинговых сессий. Работает локально через трёхслойный пайплайн. CX Codex +1 159установок

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

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