openspec-onboard

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

4|Updated May 13, 2026
One-click install
npx skills add https://github.com/RuixeWolf/modbus-simulator --skill openspec-onboard-ruixewolf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/RuixeWolf/modbus-simulator/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/RuixeWolf/modbus-simulator --skill openspec-onboard-ruixewolf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development 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, explaining each phase as it happens. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with narration at each step. - Codebase Task Discovery: Scans for TODOs, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails: Gently steers oversized tasks toward smaller slices suitable for a first workflow run-through. - Use Case: A developer new to OpenSpec picks a small fix in their repo, and the Skill creates the change container, drafts proposal/spec/design/tasks artifacts via the openspec CLI, implements the work, and archives the completed change. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using a small task in this repository.

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 with a real project?▼

Run the onboarding skill, which scans your codebase for small tasks like TODOs or missing error handling, then walks you through creating a change, drafting proposal, specs, design, and tasks, implementing them, and archiving the result.

What is an OpenSpec change and how do I create one?▼

An OpenSpec change is a container holding proposal, specs, design, and tasks artifacts for a piece of work. Create one with the openspec new change command, then fill each artifact using the openspec instructions commands.

Does OpenSpec onboarding require the openspec CLI installed?▼

Yes, the skill checks for the openspec CLI during preflight and stops if it is not installed. Install the CLI first, then rerun the onboarding command to begin the guided workflow.

What happens if I stop the OpenSpec tutorial halfway through?▼

Your change is saved on disk and nothing is lost. You can resume later with the continue command to finish remaining artifacts or jump straight to implementation if tasks already exist.

Can I use OpenSpec onboarding for a large feature?▼

The skill recommends small tasks for a first run-through and will suggest slicing large work into smaller pieces. You can override this guardrail, but the full cycle will take longer to complete.