How does this improve my development process?

It helps establish a 'think before you code' habit by requiring proposals and specs, which reduces implementation errors and creates a clear history of why changes were made.

Can I stop the tutorial mid-way?

Yes, all progress is saved in the 'openspec/changes/' directory, allowing you to resume later using the /opsx:continue or /opsx:apply commands.

What is the OpenSpec Onboard skill?

It is a specialized Claude Code skill that provides a guided tutorial for using OpenSpec, a framework for structured software development workflows.

What are the prerequisites for using this skill?

You must have the openspec CLI installed and initialized in your project directory using 'openspec init' before starting the onboarding.

Does this skill work with any codebase?

Yes, it scans your local repository for TODOs, missing tests, or type issues to find a relevant real-world task to use for the tutorial.

OpenSpec Workflow Onboarding

Name: OpenSpec Workflow Onboarding
Author: jaxxstorm

byjaxxstorm

•

Learning & Documentation

Guides developers through a complete OpenSpec change cycle from initial task discovery to implementation and archiving.

This skill provides a hands-on, interactive teaching experience for the OpenSpec framework within Claude Code. It helps developers master a disciplined workflow by scanning the codebase for improvements, creating structured documentation (proposals, specs, and designs), and managing the implementation process. By the end of the session, users will have completed a real task while building a permanent decision record for their project, making it ideal for teams adopting spec-driven development practices.

Key Features

01Automated codebase analysis to identify TODOs, bugs, and technical debt

02Interactive step-by-step guidance for creating proposals and technical specs

031 GitHub stars

04Automated archiving of completed changes for historical decision tracking

05Structured design document generation with rationale and trade-offs

06Real-time implementation tracking and task management

Use Cases

01Standardizing documentation for small-to-medium feature implementations

02Onboarding new developers to a standardized spec-driven development workflow

03Improving project maintainability by creating a searchable history of technical decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jaxxstorm/dnstrace openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill