openspec-onboard

Guide users through the complete OpenSpec CLI workflow cycle with hands-on artifact creation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

New contributors and teams often struggle to learn a project's decision workflow and tooling without doing real work; this Skill provides a guided, hands-on walkthrough that teaches the OpenSpec cycle while operating in the user's actual codebase.

Core Features & Use Cases

  • Step-by-step guided onboarding that walks through explore, propose, spec, design, tasks, apply, and archive phases.
  • Creates real change artifacts (proposal, specs, design, tasks) in openspec/changes and integrates with the OpenSpec CLI to implement and archive changes.
  • Interactive teaching with pauses for user confirmation, scope guards, and light narration, ideal for developer onboarding, pairing sessions, and team process introductions.

Quick Start

Start an interactive onboarding by asking the assistant to run the openspec-onboard workflow and guide me through creating, implementing, and archiving a small change using the OpenSpec CLI.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I onboard new developers to an OpenSpec workflow in a real codebase?

You can onboard new developers to an OpenSpec workflow by running an interactive guided tutorial that walks through explore, propose, spec, design, tasks, apply, and archive phases directly in the repository.

What is the OpenSpec change management cycle for software engineering teams?

The OpenSpec change management cycle involves exploring a codebase, drafting proposals, writing specs and tasks, implementing code, and archiving decisions to maintain structured project changes.

How do I create and archive OpenSpec proposals using the CLI?

You create and archive OpenSpec proposals by using the CLI to generate proposal, spec, design, and task artifacts, then implementing and archiving the change with user confirmation pauses.

Do I need the OpenSpec CLI installed locally to use this onboarding workflow?

Yes, you need the OpenSpec CLI installed locally because the interactive onboarding workflow operates in your actual codebase to produce real change artifacts.

Can I use OpenSpec onboarding for team pairing sessions and process introductions?

Yes, you can use OpenSpec onboarding for team pairing sessions because it provides interactive teaching with pauses for user confirmation and scope guards during real change creation.

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

The OpenSpec onboarding workflow creates proposal, specs, design, tasks, and archived change artifacts within the openspec/changes directory of your repository.