openspec-onboard

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

3|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/mambo-wang/CodingHub --skill openspec-onboard-mambo-wang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/mambo-wang/CodingHub/tree/main/.qoder/skills/openspec-onboard
Command: npx skills add https://github.com/mambo-wang/CodingHub --skill openspec-onboard-mambo-wang

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, hands-on walkthrough tied to real work in their own codebase. ## Core Features & Use Cases - Guided End-to-End Workflow: 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 supports pausing, resuming, or jumping to a command reference. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix found in their codebase, and completes a full change cycle in about 15-20 minutes while learning each artifact's purpose. ## Quick Start Ask the assistant to start the OpenSpec onboarding walkthrough and guide you through your first complete change cycle on a small task in this 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 onboarding walkthrough, which guides 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 task to work on?▼

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

Does OpenSpec onboarding require the openspec CLI installed?▼

Yes, the openspec CLI must be installed before starting. The skill checks with openspec --version during preflight and stops with an install prompt if the CLI is not found.

What happens if I stop the OpenSpec onboarding midway?▼

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

Can I use OpenSpec onboarding for a large feature?▼

It is designed for small tasks so you can see the full cycle quickly. If you pick something large, it suggests slicing it smaller, though you can override and proceed anyway.