openspec-onboard

Guide users through an OpenSpec workflow to create, implement, and archive code changes.

5|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Catsofsuffering/CCGS --skill openspec-onboard-catsofsuffering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/Catsofsuffering/CCGS/tree/main/.agents/skills/openspec-onboard
Command: npx skills add https://github.com/Catsofsuffering/CCGS --skill openspec-onboard-catsofsuffering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes uncertainty for engineers and maintainers learning OpenSpec by guiding them through a full change lifecycle inside their real codebase, turning abstract workflow steps into concrete, runnable actions.

Core Features & Use Cases

  • Guided onboarding: Step-by-step narration through creating a change, drafting a proposal, writing specs, producing a design, listing tasks, implementing code, and archiving the change.
  • Real code interaction: Works against the user's repository and OpenSpec change directories so learners perform actual edits rather than simulated examples.
  • Use Case: A developer picks a small TODO, uses the onboarding to create an OpenSpec change, implements the fix guided by specs and tasks, and archives the decision for project history.

Quick Start

Start the guided onboarding to create a change, draft proposal and specs, implement a small code task, and archive the completed change.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I create and implement an OpenSpec change in my codebase?

Guided OpenSpec onboarding walks you through drafting a proposal, writing specs, producing a design, listing tasks, implementing code, and archiving the change directly inside your repository.

What is the OpenSpec change lifecycle for repository tasks?

The OpenSpec change lifecycle is a structured workflow process for managing codebase updates. It involves creating a change proposal, writing detailed specs, designing implementation tasks, writing the actual code, and archiving the decision for project history.

Do I need an initialized OpenSpec CLI environment to use this onboarding workflow?

Yes, an initialized OpenSpec CLI environment and active repository access are required. The onboarding requires running openspec commands and writing actual change artifacts directly into your real codebase rather than using simulated examples.

How do I draft an OpenSpec proposal and write specs for a small TODO fix?

You can draft an OpenSpec proposal for a small TODO by starting the guided onboarding. It provides step-by-step narration to help you create the change, draft the proposal, write the accompanying specs, and list the implementation tasks.

Can I apply actual code changes to my repository during the OpenSpec onboarding process?

Yes, you can apply actual code changes. The onboarding works against your real repository and OpenSpec change directories, allowing you to perform actual edits and implement code fixes directly guided by the generated specs and tasks.