openspec-onboard

Run the onboarding flow, 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.

It scans your codebase for TODO and FIXME comments, missing error handling, untested functions, any types, and debug artifacts, then checks recent git history. It presents three to four scoped suggestions, or you can describe your own task.

Yes, the openspec CLI must be installed before starting. The skill runs a preflight version check and stops with an install prompt if the CLI is not found on your system.

Yes, if your work lives in a registered store, the skill discovers store ids with openspec store list --json and appends --store <id> to all spec and change commands for the rest of the workflow.

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.

The skill applies a soft scope guardrail, suggesting you slice the task smaller or pick another suggestion. You can override and proceed anyway, but it warns the cycle will take longer.