openspec-onboard

Guides users through a complete OpenSpec change workflow cycle with narrated phases.

1|1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/phuchoang2603/nixos --skill openspec-onboard-phuchoang2603
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/phuchoang2603/nixos/tree/main/home/base/cli/skills/openspec-onboard
Command: npx skills add https://github.com/phuchoang2603/nixos --skill openspec-onboard-phuchoang2603

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven workflow is hard when documentation is abstract. This Skill teaches the OpenSpec change lifecycle by walking you through a real task in your own codebase, from exploration to archiving, with explanations at every step. ## Core Features & Use Cases - Guided Workflow Tour: Walks through all phases of an OpenSpec change—explore, proposal, specs, design, tasks, implementation, and archive—with EXPLAIN/DO/SHOW/PAUSE narration. - Real Codebase Tasks: Scans your repository for TODOs, missing tests, debug artifacts, and type issues to suggest small starter tasks instead of using fake examples. - Scope Guardrails: Gently steers oversized tasks toward smaller slices so first-time users can complete a full cycle in about 15-20 minutes. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix like removing console.log statements, and completes their first full change cycle including an archived decision record. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using a small task in the current 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 using a real task in your codebase. It covers exploration, proposal, specs, design, tasks, implementation, and archiving in about 15-20 minutes.

How does OpenSpec onboarding pick a task to work on?▼

It scans your codebase for TODO and FIXME comments, missing error handling, untested functions, any types, and debug statements, then presents 3-4 small suggestions. You can also describe your own task.

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 the OpenSpec onboarding halfway?▼

Your change is saved at the changeRoot reported by openspec status. You can resume later with openspec-continue-change or jump to implementation with openspec-apply-change without losing work.

Can I use OpenSpec onboarding for a large feature?▼

The skill includes a scope guardrail that suggests slicing large tasks into smaller pieces for the first run-through. You can override it, but smaller tasks let you see the full cycle faster.