speckit-setup

Bootstrap a SPEC-ID workflow scaffold with a dedicated worktree and roadmap data.

3|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/racecraft-lab/racecraft-plugins-public --skill speckit-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-setup
Source: https://github.com/racecraft-lab/racecraft-plugins-public/tree/main/speckit-pro/codex-skills/speckit-setup
Command: npx skills add https://github.com/racecraft-lab/racecraft-plugins-public --skill speckit-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the preparation of a SPEC-ID workflow scaffold for Codex SpeckKit autopilot. It handles the bootstrap steps required to identify or create a roadmap entry, initialize or reuse a worktree, and place the initial workflow into the repository so autopilot can be launched immediately.

Core Features & Use Cases

  • Identify or create the SPEC-ID in the technical roadmap.
  • Create or attach a dedicated worktree for the SPEC, ensuring isolation from main.
  • Copy and populate the shared workflow template into docs/ai/specs/ with proper placeholders replaced.
  • Use case: a developer wants to bootstrap an autopilot workflow for SPEC-009 and proceed to grill-me interviews and workflow generation.

Quick Start

Provide a SPEC-ID to begin the setup and generate the workflow scaffold.

Frequently Asked Questions about speckit-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap a SPEC-ID workflow for Codex SpeckKit autopilot?▼

To bootstrap a SPEC-ID workflow for Codex SpeckKit autopilot, provide a SPEC-ID to automatically generate or reuse a worktree and populate a shared workflow template in the repository.

What is the best way to set up a git-worktree for an automated spec workflow?▼

The best way to set up a git-worktree for an automated spec workflow is to use a setup tool that creates or attaches a dedicated worktree, ensuring isolation from the main branch during autopilot execution.

How do I populate a workflow template with technical roadmap data for specs?▼

You populate a workflow template with technical roadmap data by copying a shared template into the docs/ai/specs/ directory and replacing placeholders with identified SPEC-ID roadmap entries to enforce consistent constraints.

Do I need an existing roadmap entry to start the SpeckKit autopilot setup?▼

You do not need an existing roadmap entry to start the SpeckKit autopilot setup, because the workflow scaffold preparation can identify an existing SPEC-ID or create a new roadmap entry automatically.

Can I use an existing worktree when preparing a SPEC-ID workflow scaffold?▼

Yes, you can use an existing worktree when preparing a SPEC-ID workflow scaffold, as the setup process is designed to initialize a new worktree or reuse a dedicated one already attached to the spec.

Why does my autopilot workflow require a dedicated worktree for SPEC-IDs?▼

An autopilot workflow requires a dedicated worktree for SPEC-IDs to ensure isolation from the main branch, allowing the automated workflow document generation to execute without conflicting with ongoing development.