Does this skill make actual changes to my code?

Yes, during the 'Apply' phase of the onboarding, the skill will implement the selected task in your codebase based on the generated specs and design artifacts.

How long does the onboarding process take?

The guided workflow typically takes between 15 and 20 minutes, depending on the complexity of the starter task you choose to work on.

Can I pause the onboarding session and finish it later?

Absolutely. Your progress is saved in the OpenSpec change directory. You can stop at any time and resume using the /opsx:continue or /opsx:apply commands.

OpenSpec is a structured methodology and CLI tool for managing the lifecycle of code changes through formal proposals, specifications, and technical designs.

What happens if I don't have the OpenSpec CLI installed?

The skill requires the OpenSpec CLI to function. It will check your project status and prompt you to run 'openspec init' if the environment is not yet set up.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: mvdmakesthings

bymvdmakesthings

0•

Learning & Documentation

Guides developers through their first complete OpenSpec workflow cycle by performing real codebase tasks with narrated instruction.

The OpenSpec Onboarding skill provides an interactive, hands-on tutorial for the OpenSpec methodology within Claude Code. It automates the process of identifying small improvement opportunities in a repository—such as fixing TODOs, addressing type issues, or improving error handling—and then walks the user through the entire lifecycle of a change. From initial exploration and specification to implementation and archiving, this skill ensures developers learn the OpenSpec rhythm by doing real work in their own codebase with helpful guardrails and expert narration.

Key Features

01Intelligent scope guardrails to ensure starter tasks are appropriately sized for a first-time learning experience.

02Integrated CLI automation for creating change containers, saving artifacts, and archiving completed work.

03Automated codebase scanning to identify ideal starter tasks like TODOs, missing tests, or type issues.

040 GitHub stars

05Step-by-step guidance through the full OpenSpec lifecycle: Explore, Proposal, Specs, Design, and Tasks.

06Interactive implementation where Claude performs real work while explaining how specs and design inform the code.

Use Cases

01Introducing structured specification and design workflows to an existing project.

02Onboarding new team members to an OpenSpec-driven development environment.

03Learning the OpenSpec CLI commands and artifact structure through practical application.

Key Features

01Intelligent scope guardrails to ensure starter tasks are appropriately sized for a first-time learning experience.

02Integrated CLI automation for creating change containers, saving artifacts, and archiving completed work.

03Automated codebase scanning to identify ideal starter tasks like TODOs, missing tests, or type issues.

040 GitHub stars

05Step-by-step guidance through the full OpenSpec lifecycle: Explore, Proposal, Specs, Design, and Tasks.

06Interactive implementation where Claude performs real work while explaining how specs and design inform the code.

Use Cases

01Introducing structured specification and design workflows to an existing project.

02Onboarding new team members to an OpenSpec-driven development environment.

03Learning the OpenSpec CLI commands and artifact structure through practical application.