skill-studio
- Repo stars 217
- Author updated Live
- Author repo claude-skills
- Domain
- Design
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @glebis · no license declared
- Token usage
- Moderate
- Setup complexity
- Guided setup
- External API key
- Required · Anthropic
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python >=3.11
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skill-studio
description: Interview-driven automation design tool. This skill should be used when the user wants to design…
category: design
runtime: Python
---
# skill-studio output preview
## PART A: Task fit
- Use case: 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"..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Purpose / Architecture / When to use” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “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".”.
- **02** When the source has headings, the agent prioritizes “Purpose / Architecture / When to use” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; may access external network resources; requires Anthropic API keys.
## Running Rules
- read files, write/modify files; may access external network resources; requires Anthropic API keys.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/skill-creator`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “Purpose / Architecture / When to use”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: skill-studio
description: Interview-driven automation design tool. This skill should be used when the user wants to design…
category: design
source: glebis/claude-skills
---
# skill-studio
## When to use
- Interview-driven automation design tool. This skill should be used when the user wants to design a new skill, agent, a…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Purpose / Architecture / When to use” and keep inference separate from source facts.
- read files, write/modify files; may access external network resources; requires Anthropic API keys.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "skill-studio" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Purpose / Architecture / When to use
rules -> SKILL.md triggers / order / output contract
runtime -> Python | read files, write/modify files | may access external network resources
guardrails -> requires Anthropic API keys + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} 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-studioCLI on PATH (pip install -e .inside the skill directory, orskill-studio initfor guided setup)- Python 3.11+
- Text mode needs no API key — the interview runs natively inside Claude Code
- Voice mode (
--voice) needsDAILY_API_KEY,GROQ_API_KEY,DEEPGRAM_API_KEY, and an LLM provider key (OPENROUTER_API_KEYby 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:
# 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:
- 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.
- Single LLM call — over that compact bundle only, proposes a partial DesignJSON patch with a
rationalemap 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 withdescription,subagent_type, andprompt_snippetskills— skill invocations observed during the sessiontool_sequence— ordered list of all tool calls with descriptionstool_frequency— how often each tool was usedworkflow_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:
# 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:
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:
{"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:
{"needs.functional": ["transcribe audio", "extract action items"], "guardrails": ["never send notes without review"]}
Example with object-list field (scenarios):
{"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.
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
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:
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 sessionsskill-studio list-sessions— list Claude Code sessions (most recent first)skill-studio list-sessions --project <name>— filter by projectskill-studio export <id> md-svg— regeneratedesign.md+design.svgskill-studio coverage <id>— per-field confidence JSONskill-studio next-target <id>— ask-this-next hintskill-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 logdesign.md,design.svg— exported artifacts
Troubleshooting
skill-studio: command not found— Runpip install -e <skill-studio-base-dir>and retry.apply-patchreturns an error — Verify the JSON patch is valid (keys must match schema fields above). Runskill-studio coverage <session_id>to inspect current state.- Session not found — Always run
new-sessionbefore the firstapply-patch. There is no implicit session creation. Runskill-studio listto check existing sessions. - Voice mode key errors — Run
skill-studio initto 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 isopenrouter).
Decide Fit First
Design Intent
How To Use It
Boundaries And Review