How long does the onboarding process take?

A typical walkthrough takes approximately 15-20 minutes, depending on the complexity of the small task you choose to implement.

Does this skill require any external software?

Yes, it requires the OpenSpec CLI to be installed and initialized in your project directory to function correctly.

What is the primary goal of the OpenSpec Onboard skill?

The goal is to teach the OpenSpec workflow—Explore, New, Proposal, Specs, Design, Tasks, Apply, and Archive—by performing a real, small-scale task in your own codebase.

What happens if I need to stop the tutorial before finishing?

Your progress is automatically saved within the 'openspec/changes/' directory. You can resume at any time using the '/opsx:continue' or '/opsx:apply' commands.

Can I use this on a project that hasn't used OpenSpec before?

Absolutely. If your project isn't initialized, the skill will guide you to run 'openspec init' before starting the tutorial cycle.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

Guides users through their first complete OpenSpec development cycle with interactive narration and real codebase implementation.

The OpenSpec Onboard skill provides a hands-on, interactive tutorial designed to master the OpenSpec workflow directly within your repository. It analyzes your codebase to suggest real improvement opportunities, then walks you through the entire lifecycle of a change—from drafting proposals and testable specifications to technical design, implementation, and final archiving. By performing real work while explaining the 'why' behind each artifact, this skill bridges the gap between conceptual documentation and practical application, making it an essential tool for teams adopting structured development patterns.

Key Features

01Guided implementation phase with task-by-task narration

02Structured archiving of completed changes for permanent decision records

03Hands-on tutorial for OpenSpec CLI command integration

040 GitHub stars

05Automated codebase scanning for TODOs, missing tests, and type issues

06Interactive drafting of proposals, specs, and design documents

Use Cases

01Onboarding developers to projects using the OpenSpec methodology

02Learning how to bridge the gap between technical design and code implementation

03Establishing a standardized documentation and change management workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add blackbelttechnology/judo-generator-commons openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill