skills.rest
JhonMA82
JhonMA82COMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

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

Updated Aug 5, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#guided learning#change workflow
One-click install
npx skills add https://github.com/JhonMA82/api-starter --skill openspec-onboard-jhonma82
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/JhonMA82/api-starter/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/JhonMA82/api-starter --skill openspec-onboard-jhonma82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven workflow is hard without hands-on practice. This Skill teaches the OpenSpec change lifecycle by walking you through a real task in your own codebase, from proposal to archive, with explanations at every step. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving 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 oversized tasks toward smaller slices while respecting user choice, and handles mid-session exits gracefully. - 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 tutorial and walk you through your first complete change cycle on a real 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 openspec-onboard skill, which guides you through a complete change cycle on 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, any types, debug statements, and missing validation, then checks recent git history. It presents 3-4 small, specific suggestions for you to choose from.

Does openspec-onboard require the OpenSpec CLI installed?▼

Yes, the skill checks for the CLI with openspec --version during preflight and stops if it is not installed. You must install the OpenSpec CLI first, then rerun the onboarding command.

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

Your change is saved at the changeRoot reported by openspec status, so no work is lost. You can resume later with /opsx-continue to continue artifact creation or /opsx-apply to jump to implementation if tasks exist.

Can I use the onboarding for a large feature instead of a small task?▼

The skill applies a soft scope guardrail suggesting you slice large tasks smaller, pick another suggestion, or proceed anyway. It respects your choice if you insist, but warns the cycle will take longer.

Related Skills

Explore More Software Engineering Skills→
aehrcaehrc
133

openspec-new-change

Scaffold a new change directory in the OpenSpec system.

Official
Intermediate
kuchida1981kuchida1981

openspec-onboard

Guides a complete OpenSpec workflow from task discovery to archival.

Community
Advanced
runtime-envruntime-env
47

openspec-verify-change

Generate structured verification reports for OpenSpec change implementations.

Official
Advanced
Akiyama-samaAkiyama-sama

openspec-apply-change

Automate task implementation from OpenSpec changes using the openspec CLI.

Community
Intermediate