skills.rest
twaananen
twaananenCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

Guides users through a complete OpenSpec workflow cycle with narrated codebase tasks.

Updated Mar 13, 2026
Search Tags:#workflow#onboarding#cli#tutorial#change management#spec-driven development#openspec
One-click install
npx skills add https://github.com/twaananen/6dof-drone-sim --skill openspec-onboard-twaananen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/twaananen/6dof-drone-sim/tree/main/.agents/skills/openspec-onboard
Command: npx skills add https://github.com/twaananen/6dof-drone-sim --skill openspec-onboard-twaananen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New OpenSpec users struggle to learn the change-driven workflow (proposal, specs, design, tasks, apply, archive) without a hands-on walkthrough tied to real work in their own codebase. ## Core Features & Use Cases - Guided Workflow Onboarding: Walks through the full OpenSpec cycle—explore, create change, proposal, specs, design, tasks, implementation, and archive—with explanations at each phase. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails & Graceful Exits: Steers users toward appropriately sized first tasks and supports pausing or resuming via /opsx:continue. - 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 command. ## Quick Start Ask the assistant to start the OpenSpec onboarding walkthrough and guide you through your first change using a 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 walkthrough, which guides you through a full change cycle: explore, create a change, draft a proposal, write specs and design, implement tasks, and archive. It uses a real small task from your own codebase and takes about 15-20 minutes.

How does OpenSpec onboarding pick a task to work on?▼

It scans your codebase for TODO/FIXME comments, missing error handling, untested functions, TypeScript any types, and debug statements, plus recent git history. It then presents 3-4 small, well-scoped suggestions for you to choose from.

Does the OpenSpec onboarding skill require the openspec CLI?▼

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 happens if I stop the OpenSpec onboarding halfway through?▼

Your change is saved under openspec/changes/<name>/ and nothing is lost. You can resume later with /opsx:continue <name> to finish artifacts or /opsx:apply <name> to jump to implementation.

Can I use a large feature for my first OpenSpec change?▼

You can, but the skill recommends a smaller task for learning the workflow. It offers to slice the work smaller, pick another task, or proceed anyway if you insist—the guardrail is soft.

Related Skills

Explore More Software Engineering Skills→
pabloimrik17pabloimrik17

openspec-onboard

Guide users through a complete OpenSpec workflow cycle in their codebase.

Community
Intermediate
PBH-BTNPBH-BTN
6.2k

openspec-bulk-archive-change

Archives multiple completed OpenSpec changes with conflict detection and spec synchronization.

Official
Advanced
ywh0606ywh0606

opsx-explore

Explore software development ideas and clarify requirements before implementation.

Community
Intermediate
jiangzhejiangzhe
121

issue

Convert planning documents into GitHub issues with lifecycle management.

Community
Advanced