expand-shell

Solid

Expand a shell into a full implementation plan. Verifies Consumes against the current codebase, runs a fresh pattern survey, escalates open questions, and fills in concrete file references and verification. Use when the user asks to "expand a shell", "expand shell", "fill in the shell", "expand the shell", or "concretize the shell".

AI & Automation 312 stars 24 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
83
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Expand Shell Expand a shell into a full implementation plan. The shell's Context, Produces, Consumes, Covers, and high-level Implementation Steps are authoritative. Expansion adds a pattern survey, concrete references, and verification, writes the plan to `.turbo/plans/<shell-slug>.md`, and deletes the source shell once the plan is in place. ## Task Tracking Use `TaskCreate` to create a task for each step: 1. Load the shell and verify consumes 2. Run `/survey-patterns` skill (shell-focused) 3. Escalate the shell's open questions 4. Write the plan 5. Verify the plan against the shell 6. Present summary and gate 7. Delete the shell ## Step 1: Load the Shell and Verify Consumes Determine which shell to expand: 1. **Explicit path** — If a file path was passed, use it 2. **Single candidate** — Glob `.turbo/shells/*.md` and filter to shells whose `depends_on` are all satisfied (see satisfaction check below). If exactly one match, use it 3. **Multiple candidates** — If multiple matches, use `AskUserQuestion` to let the user choose 4. **Nothing found** — If no shells exist in `.turbo/shells/`, say so and stop A `depends_on` entry is satisfied when `.turbo/plans/<dep-slug>.md` exists with `status: done` in its frontmatter. Read the shell file. Parse the YAML frontmatter: - **spec** (source spec path) - **depends_on** (list of shell slugs that must already be implemented) Parse these body fields: - **Title** (from the `# Plan:` heading) - **Context** (the why) - **Produce...

Details

Author
tobihagemann
Repository
tobihagemann/turbo
Created
2 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

pick-next-shell

Pick the next shell whose dependencies are satisfied and carry it through planning: expand, refine, self-improve, halt. Use when the user asks to "pick next shell", "next shell", "continue project", "what's next", "next implementation step", or "continue with the plan".

312 Updated today
tobihagemann
Data & Documents Solid

draft-shells

Decompose a specification file into shells with YAML frontmatter. Each shell captures the wiring invariants (Produces, Consumes, Covers) and high-level Implementation Steps without committing to file paths. Use when the user asks to "draft shells", "create shells", "break spec into shells", "decompose spec into sessions", "draft shells from spec", "generate shells from spec", or "make shells from spec".

312 Updated today
tobihagemann
Code & Development Solid

refine-plan

Iteratively review and revise an implementation plan until no new findings survive evaluation. Runs /review-plan, /evaluate-findings, /apply-findings, then re-runs itself until stable. Use when the user asks to "refine the plan", "refine this plan", "iterate on the plan", "tighten the plan", or "improve the plan".

312 Updated today
tobihagemann
AI & Automation Solid

implement-plan

Execute an implementation plan file produced by /draft-plan or /turboplan. Runs pre-implementation prep, loads task-specific skills by matching plan content against available skill triggers, executes the plan steps, and runs /finalize. Use when the user asks to "implement plan", "implement the plan", "execute the plan", "run the plan", "implement plans/<slug>.md", "start implementing the plan", or starts a fresh session to implement a previously drafted plan.

312 Updated today
tobihagemann
Data & Documents Solid

migrate-turbo-files

Migrate legacy files in .turbo/ to current formats. Covers plans and shells (layout split, frontmatter normalization, prompt-plan index cleanup) and improvements.md (legacy `trivial`/`standard` Type values rewritten to `direct`/`plan`). Use when the user asks to "migrate turbo files", "migrate turbo", "migrate turboplans", "migrate turbo plans", "upgrade plan format", "add frontmatter to plans", "convert old plans", or "migrate improvements".

312 Updated today
tobihagemann