openspec-onboard

Guide developers through OpenSpec workflow phases using the OpenSpec CLI.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/arestivo/qoodle --skill openspec-onboard-arestivo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/arestivo/qoodle/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/arestivo/qoodle --skill openspec-onboard-arestivo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a guided OpenSpec onboarding workflow that teaches developers to complete a full OpenSpec cycle by performing concrete tasks directly in their codebase.

Core Features & Use Cases

  • Step-by-step Onboarding: Walks through initialization, phase transitions, and artifact creation (proposal, specs, design, tasks) using real OpenSpec commands.
  • Hands-on Task Execution: Guides users to make and archive changes, reinforcing the EXPLAIN → DO → SHOW → PAUSE rhythm.
  • Reproducible Workflow: Produces a traceable openspec/changes/<name>/ folder structure with proposal.md, specs/, design.md, and tasks.md.

Quick Start

Run through the guided onboarding in a fresh project by executing the OpenSpec CLI steps as described in the Phase sections.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I start using OpenSpec for change management in my codebase?▼

OpenSpec onboarding starts by checking initialization and guiding you phase-by-phase to create a change container with proposal.md, specs, design.md, and tasks.md using the CLI.

What is the OpenSpec workflow cycle for coding tasks?▼

The OpenSpec workflow cycle walks developers from welcome to archive, creating artifacts for exploration, proposal, specs, design, tasks, and implementation while enforcing an EXPLAIN, DO, SHOW, PAUSE rhythm.

How do I create and archive structured changes using the OpenSpec CLI?▼

You create and archive changes by following a guided workflow that uses the OpenSpec CLI to generate a traceable openspec/changes/<name>/ folder containing proposal.md, specs, design.md, and tasks.md.

Do I need a fresh project to run the OpenSpec onboarding workflow?▼

Running the guided onboarding in a fresh project is recommended. The workflow verifies initialization and then performs real work in your codebase to teach the complete cycle.

What artifacts does OpenSpec generate during the onboarding process?▼

OpenSpec onboarding generates a reproducible folder structure under openspec/changes/<name>/ that includes proposal.md, specs, design.md, and tasks.md to ensure traceable change management.