openspec-onboard

Guide new contributors through the complete OpenSpec workflow in a codebase.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/HerbertGao/qsl-cardhub --skill openspec-onboard-herbertgao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/HerbertGao/qsl-cardhub/tree/main/.cursor/skills/openspec-onboard
Command: npx skills add https://github.com/HerbertGao/qsl-cardhub --skill openspec-onboard-herbertgao

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? OpenSpec onboarding provides a guided, hands-on introduction to the complete OpenSpec workflow inside a real codebase, helping new contributors learn the process by doing.

## Core Features & Use Cases

  • Step-by-step initialization checks and onboarding for a project using OpenSpec.
  • Guided progression through creating a change, drafting a proposal, writing specs, designing, planning tasks, implementing, and archiving.
  • Use Case: A new developer joins a project and completes a full OpenSpec cycle to learn the workflow within their repository.

Quick Start

Ensure OpenSpec CLI is installed and initialized in the repository, then start a new change via openspec-cn and follow the prompts to fill proposal, specs, design, tasks, and implement.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I complete a full OpenSpec workflow inside a real codebase?

To complete an OpenSpec workflow, you initialize the project, create a change, draft a proposal, write specifications, design, plan tasks, implement, and archive for historical traceability through a guided onboarding experience.

What is the guided OpenSpec onboarding process for new contributors?

OpenSpec onboarding walks new contributors through a complete workflow inside a real codebase, covering initialization, creating a change, drafting proposals, writing specs, designing, planning tasks, implementing, and archiving.

Do I need the OpenSpec CLI installed to start the onboarding workflow?

Yes, the OpenSpec CLI must be installed and initialized in your repository before starting the guided workflow, which assumes a project structure compatible with openspec-cn and standard openspec directories.

Can I use the OpenSpec onboarding workflow with any project repository structure?

The workflow requires a project repository structure compatible with openspec-cn and standard openspec directories to properly guide you through proposal drafting, specification writing, and task implementation.

What's the best way to learn the OpenSpec workflow as a new developer joining a project?

The best way to learn is hands-on by completing a full OpenSpec cycle inside your repository, starting a new change via openspec-cn and following guided prompts to fill proposal, specs, design, tasks, and implementation.

Why does the OpenSpec workflow include archiving as a final step?

Archiving is included in the OpenSpec workflow to ensure historical traceability after you implement changes, preserving the complete cycle from proposal and specifications through design and task planning for future reference.