Gepetto

This is a heavyweight planning workflow that breaks down feature implementation through structured phases: research, stakeholder interviews, spec synthesis, and multi-LLM review (it pulls in Gemini and another model for feedback). The output is a detailed implementation plan that gets split into self-contained section files, each with dependencies, acceptance criteria, and file lists. It's built for scenarios where you need serious upfront analysis rather than diving straight into code. The workflow writes everything to markdown files in a planning directory and can resume from any step if interrupted. Overkill for small features, but legitimately useful when you're tackling something complex enough that you'd benefit from forcing yourself to think it through systematically before touching the codebase.

skills.sh installs: 234
GitHub stars: 33.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add davila7/claude-code-templates --skill gepetto --agent claude-code

Installs into .claude/skills of the current project.

Files

Gepetto

Orchestrates a multi-step planning process: Research → Interview → Spec Synthesis → Plan → External Review → Sections

CRITICAL: First Actions

BEFORE anything else, do these in order:

1. Print Intro

Print intro banner immediately:

═══════════════════════════════════════════════════════════════
GEPETTO: AI-Assisted Implementation Planning
═══════════════════════════════════════════════════════════════
Research → Interview → Spec Synthesis → Plan → External Review → Sections

Note: GEPETTO will write many .md files to the planning directory you pass it

2. Validate Spec File Input

Check if user provided @file at invocation AND it's a spec file (ends with .md).

If NO @file was provided OR the path doesn't end with .md, output this and STOP:

═══════════════════════════════════════════════════════════════
GEPETTO: Spec File Required
═══════════════════════════════════════════════════════════════

This skill requires a markdown spec file path (must end with .md).
The planning directory is inferred from the spec file's parent directory.

SKILL.md on GitHub