openspec-onboard

Guide users through the OpenSpec workflow from exploration to archival.

11|3|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/DarkHighness/coi-public --skill openspec-onboard-darkhighness
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/DarkHighness/coi-public/tree/main/.gemini/skills/openspec-onboard
Command: npx skills add https://github.com/DarkHighness/coi-public --skill openspec-onboard-darkhighness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding can be intimidating for new users. This skill provides a structured, narrated walkthrough that teaches the end-to-end OpenSpec workflow in a hands-on way.

Core Features & Use Cases

  • Step-by-step onboarding narrative guiding a new user through initialization, task creation, and artifact management.
  • Real codebase interaction: the guide performs representative tasks inside the user's repository to illustrate the OpenSpec process.
  • Flexible pedagogy: adapts to different project structures while preserving the core change-cycle rhythm.

Quick Start

Run the onboarding skill to start a guided OpenSpec session and follow the narrated tasks.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I learn the OpenSpec workflow for a new codebase?▼

OpenSpec onboarding provides a guided, hands-on walkthrough that teaches the end-to-end workflow by performing real codebase tasks. It narrates the entire change-cycle from initializing a change to archiving the result.

What is the OpenSpec change management process from start to finish?▼

The OpenSpec change management process covers initializing a change, drafting a proposal, drafting specs and design, creating tasks, applying changes, and archiving the result. Artifacts are recorded in openspec/changes to enable traceability.

How do I start a guided OpenSpec onboarding session step by step?▼

Run the onboarding skill to start a guided OpenSpec session and follow the narrated tasks. It uses a predictable EXPLAIN → DO → SHOW → PAUSE pattern to lead you through real codebase interaction.

Can I use OpenSpec onboarding with my existing project structure?▼

Yes, the onboarding guide adapts to different project structures while preserving the core change-cycle rhythm. It performs representative tasks inside your repository to illustrate the OpenSpec process.

Does OpenSpec onboarding keep codebase sessions focused and safe?▼

Yes, the guided workflow includes guardrails to keep sessions focused and safe. It enforces a predictable EXPLAIN → DO → SHOW → PAUSE pattern to ensure structured and traceable artifact management.

Where are OpenSpec task artifacts and design specs stored?▼

OpenSpec task artifacts and design specs are recorded in the openspec/changes directory. This enables traceability throughout the change management workflow from proposal to archival.