openspec-onboard

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

5|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/8007342/tillandsias --skill openspec-onboard-8007342
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/8007342/tillandsias/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/8007342/tillandsias --skill openspec-onboard-8007342

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 doing real work in your codebase, walking you from task selection through proposal, specs, design, tasks, implementation, and archiving with explanations at each step. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through all phases of an OpenSpec change—explore, new change, proposal, specs, design, tasks, apply, and archive—with EXPLAIN/DO/SHOW/PAUSE narration. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails: Gently steers users toward small tasks suitable for a first run-through while respecting user choice. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix like removing console.log statements, 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 a small real 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 onboarding skill, which walks you through a complete change cycle using a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archiving with explanations at each phase, taking 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, TypeScript any types, and debug artifacts like console.log. It then presents 3-4 small suggestions with location and scope estimates for you to choose from.

What happens if the openspec CLI is not installed?▼

The skill runs a preflight check with openspec --version before starting. If the CLI is missing, it tells you to install OpenSpec CLI first and stops, since all workflow commands depend on it.

Can I stop the OpenSpec onboarding halfway through?▼

Yes, the skill handles graceful exits. Your change is saved at the changeRoot path, and you can resume later with /opsx-continue for artifact creation or /opsx-apply to jump to implementation if tasks exist.

What if my chosen task is too large for a first OpenSpec run?▼

The skill applies a soft scope guardrail, suggesting you slice the task smaller, pick a different suggestion, or proceed anyway. It recommends smaller tasks for learning but respects your choice if you insist on the larger scope.