openspec-bootstrap

Initialize OpenSpec for spec-driven development in uninitialized repositories.

Updated Mar 22, 2018
One-click install
npx skills add https://github.com/tnunamak/dotfiles --skill openspec-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bootstrap
Source: https://github.com/tnunamak/dotfiles/tree/main/ai/skills/local/openspec-bootstrap
Command: npx skills add https://github.com/tnunamak/dotfiles --skill openspec-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted effort by bootstrapping a spec-driven OpenSpec workflow when a repository hasn’t been initialized yet.

Core Features & Use Cases

  • Detects initialization state: Checks whether an openspec/ directory already exists at the repo root to determine if slash commands should be used immediately.
  • Guides one-time setup: Offers the correct openspec init approach when openspec/ is missing, tailored to the agents you plan to use.
  • Hands off control after setup: Ensures OpenSpec’s own skills and operational commands take over once initialization is complete.

Use case example: A developer starts spec-driven development in a new repo and wants to use OpenSpec with Claude and Codex; this Skill helps initialize OpenSpec so that /opsx:propose, /opsx:explore, /opsx:apply, and /opsx:archive become available after setup.

Quick Start

Ask the assistant to bootstrap OpenSpec by checking whether openspec/ exists and, if it does not, initializing it with the tools you plan to use.

Frequently Asked Questions about openspec-bootstrap

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

FAQPage Schema
How do I initialize OpenSpec for spec-driven development in a new repository?

This Skill checks if an `openspec/` directory exists and proposes the correct `openspec init` command tailored to your agents. Once initialization is complete, OpenSpec's slash commands become your primary workflow.

What is the OpenSpec workflow and when do I need to bootstrap it?

OpenSpec is a spec-driven workflow using slash commands like `/opsx:propose` and `/opsx:apply`. You bootstrap it when starting spec-driven work in a repository lacking an `openspec/` directory, ensuring commands are available before development.

Can I use OpenSpec with both Claude and Codex agents?

Yes, you can use OpenSpec with Claude and Codex. During setup, this Skill proposes an `openspec init` command that detects and configures the workflow specifically for the agents you plan to use.

How do I know if my repository is already set up for OpenSpec?

A repository is set up for OpenSpec if an `openspec/` directory exists at the root. This Skill automatically checks for this directory to determine if slash commands should be used immediately or if initialization is still required.

What happens after I initialize OpenSpec in my project?

After initializing OpenSpec, control hands off to OpenSpec’s own skills and operational commands. Slash commands like `/opsx:explore` and `/opsx:archive` become the primary workflow for your spec-driven development.