skills.rest
ismaelsoilet
ismaelsoiletCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-onboard

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

Updated Jun 25, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#proposal#change workflow
One-click install
npx skills add https://github.com/ismaelsoilet/ismaelsoilet-landing --skill openspec-onboard-ismaelsoilet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/ismaelsoilet/ismaelsoilet-landing/tree/main/.cursor/skills/openspec-onboard
Command: npx skills add https://github.com/ismaelsoilet/ismaelsoilet-landing --skill openspec-onboard-ismaelsoilet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development 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 in one narrated session. - 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 learning run. - 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 start the OpenSpec onboarding walkthrough and guide 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 guided onboarding, which walks you through a complete change cycle on a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archiving in about 15-20 minutes.

What is a change in OpenSpec?▼

A change is a container for all planning artifacts around a piece of work, holding proposal.md, design.md, specs/, and tasks.md files. You create one with openspec new change and archive it when implementation is complete.

Does OpenSpec onboarding require the CLI installed?▼

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

What tasks are good for a first OpenSpec change?▼

Small, focused tasks work best, such as fixing TODO comments, adding missing error handling, or removing debug statements. The onboarding scans your codebase and suggests 3-4 candidates of roughly 15-30 lines of change.

Can I pause the OpenSpec onboarding and resume later?▼

Yes, your change is saved on disk at any point. Resume later with /opsx-continue to continue artifact creation or /opsx-apply to jump to implementation if tasks already exist.

Related Skills

Explore More Software Engineering Skills→
rpamisrpamis
2.9k

openspec-onboard

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

Official
Intermediate
etrigan16etrigan16

sdd-onboard

Guides users through a complete spec-driven development cycle on a real codebase.

Community
Advanced
PBH-BTNPBH-BTN
6.2k

openspec-explore

Explores ideas, investigates codebases, and clarifies requirements before implementation.

Official
Intermediate
UnterrainerInformatikUnterrainerInformatik

openspec-ff-change

Generates all OpenSpec change artifacts in one pass using the openspec CLI.

Official
Intermediate