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.