skills.rest
thewoolleyman
thewoolleymanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-onboard

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New OpenSpec users struggle to learn the spec-driven change workflow (proposal, specs, design, tasks, apply, archive) without a structured, hands-on walkthrough using real work in their own codebase. ## Core Features & Use Cases - Guided Workflow Tutorial: Walks through all phases of an OpenSpec change cycle—explore, create change, proposal, specs, design, tasks, implementation, and archive—with explanations at each step. - Codebase Task Discovery: Scans the codebase for TODO/FIXME comments, missing tests, debug artifacts, and type issues to suggest small starter tasks. - Scope Guardrails & Graceful Exits: Steers users toward appropriately sized first tasks and handles mid-session pauses with resume instructions. - Use Case: A developer new to OpenSpec runs the onboarding skill, picks a small TODO fix from the suggestions, and completes a full change cycle ending with an archived decision record in openspec/changes/archive/. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using a small real task from 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 onboarding skill, which walks you through a full change cycle using a real task in your codebase. It covers creating a change, drafting a proposal, writing specs and design, implementing tasks, and archiving the result.

What is an OpenSpec change and how do I create one?▼

An OpenSpec change is a container in openspec/changes/<name>/ holding a proposal, specs, design, and tasks for a piece of work. Create one with the openspec new change command, then fill in each artifact.

Does OpenSpec onboarding require the openspec CLI installed?▼

Yes, the skill checks for the openspec CLI in a preflight step and stops if it is not installed. Install the CLI first, then rerun the onboarding command.

What happens if I stop an OpenSpec onboarding session midway?▼

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

What size task should I pick for my first OpenSpec change?▼

Pick a small task of one or two files and roughly 20-30 lines, such as a TODO fix or missing validation. The skill suggests candidates from codebase scans and gently steers you away from multi-day work.

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
etrigan16etrigan16

sdd-onboard

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

Community
Advanced
anionDevelopmentanionDevelopment

openspec-explore

Explores ideas and clarifies requirements through OpenSpec change artifacts and codebase investigation.

Official
Advanced
mickpletchermickpletcher
14

spec-writer

Convert rough repo change ideas into numbered spec folders with requirements, plans, and task lists.

Community
Intermediate