openspec-onboard

Guide developers through an OpenSpec change workflow and create change artifacts.

54|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-onboard-mrclrchtr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/mrclrchtr/SuPi/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-onboard-mrclrchtr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill teaches and guides developers through a complete OpenSpec change cycle so they can learn the process by doing real work in their codebase, reducing uncertainty and onboarding time.

Core Features & Use Cases

  • Guided, step‑by‑step workflow from idea to archive: task selection, explore mode, change creation, proposal drafting, specs, design, tasks, implementation, and archiving.
  • Safe preflight checks and scope guardrails to keep the first run concise and focused while allowing overrides for larger work.
  • Practical teaching experience that edits the repository, saves artifacts under openspec/changes, and integrates with the OpenSpec CLI for reproducible project records.

Quick Start

Run the OpenSpec CLI onboard command in your project directory to start a guided change workflow that creates a change container, drafts proposal and specs, and walks you through implementation and archiving.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I start an OpenSpec change workflow for my project?

Run the OpenSpec CLI onboard command in your project directory to start a guided change workflow. This initializes a change container, drafts proposals, defines specs, and walks you through implementation and archiving.

What is the OpenSpec change cycle and how does it work?

The OpenSpec change cycle is a structured workflow moving from task selection to archiving. It guides developers through proposal drafting, spec definition, design, implementation, and archiving to create reproducible project records under openspec/changes.

Do I need the OpenSpec CLI installed to manage specs and changes?

Yes, the OpenSpec CLI must be installed to use this guided workflow. You also need access to your project's git working tree to create and save change artifacts, proposals, and specs under the openspec/changes directory.

Can I override scope guardrails when creating larger OpenSpec changes?

Yes, preflight checks and scope guardrails keep your initial OpenSpec run concise and focused, but you can apply overrides to manage larger changes and tasks that exceed the default safe scope limits.

What artifacts does the OpenSpec onboarding process create in my repository?

The OpenSpec onboarding process creates and saves change artifacts in a change container under the openspec/changes directory. These include drafted proposals, defined specs, design records, and implementation tasks for reproducible project tracking.