skills.rest
lstellway
lstellwayCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-onboard

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

Updated Nov 7, 2023
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#proposal#change workflow
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill openspec-onboard-lstellway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/openspec-onboard
Command: npx skills add https://github.com/lstellway/nixfiles --skill openspec-onboard-lstellway

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 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 OpenSpec phases—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 their final choice. - 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, ending with an archived decision record. ## Quick Start Ask the assistant to start the OpenSpec onboarding tutorial and walk you through your first complete change cycle 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 for the first time?▼

Run the onboarding flow, 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 with explanations at each phase, taking about 15-20 minutes.

What commands does OpenSpec provide for managing changes?▼

Core commands are /opsx:propose to create a change with all artifacts, /opsx:explore to think through problems, /opsx:apply to implement tasks, and /opsx:archive to archive completed changes. Additional commands include /opsx:new, /opsx:continue, /opsx:ff, and /opsx:verify.

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 happens if I stop the OpenSpec tutorial midway?▼

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

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

It scans the codebase for TODO/FIXME comments, missing error handling, untested functions, any-type usage, and debug artifacts, then checks recent git history. It presents 3-4 small scoped suggestions and lets you pick or propose your own.

Related Skills

Explore More Software Engineering Skills→
wtg42wtg42

openspec-onboard

Guide OpenSpec CLI users through a complete change workflow with proposal, specs, design, tasks, and archive artifacts.

Community
Intermediate
manishsinghmfmanishsinghmf

openspec-onboard

Guide new users through OpenSpec change management from proposal to archive.

Community
Intermediate
vidos-idvidos-id
1

openspec-verify-change

Verify code implementations against change artifacts using the openspec CLI.

Official
Advanced
ajilantonyajilantony

copilot-cli-quickstart

Guide users through GitHub Copilot CLI tutorials with interactive Q&A.

Community
Intermediate