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.