openspec-onboard

Guides users through a complete OpenSpec change workflow with narrated phases and real codebase tasks.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill openspec-onboard-codercoco-studios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/CoderCoco-Studios/Hyveon/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill openspec-onboard-codercoco-studios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New OpenSpec users often struggle to learn the change-driven workflow (proposal, specs, design, tasks, apply, archive) without a structured walkthrough, leading to skipped artifacts or abandoned changes. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through every OpenSpec phase—explore, new change, proposal, specs, design, tasks, apply, and archive—with explanations at each step. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails & Graceful Exits: Steers users toward appropriately sized first tasks and preserves progress when users pause mid-workflow. - Use Case: A developer new to OpenSpec runs the onboarding skill, picks a small fix from the suggestions, and completes a full change cycle in about 15-20 minutes while learning each artifact's purpose. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using the openspec-onboard skill on a small task in your codebase.

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 the first time?

Run the openspec-onboard skill, which walks you through a full change cycle on a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archiving with explanations at each phase.

How does OpenSpec onboarding pick a starter task?

It scans your codebase for TODO/FIXME comments, missing error handling, untested functions, any types, and debug artifacts, then presents 3-4 small suggestions. You can also describe your own task, with a soft guardrail against oversized scope.

Does openspec-onboard require the OpenSpec CLI installed?

Yes, the skill checks for the openspec CLI in a preflight step and stops if it is not installed. Install the CLI first, then rerun the onboarding command.

What happens if I stop an OpenSpec onboarding session midway?

Your change is saved at the changeRoot reported by openspec status. You can resume later with /opsx:continue for artifact creation or /opsx:apply to jump to implementation if tasks already exist.

Can I use openspec-onboard with a registered OpenSpec store?

Yes, run openspec store list --json to discover registered store ids, then pass --store <id> on commands that read or write specs and changes. Without a store flag, commands act on the nearest local openspec/ root.