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.