Does this skill make real changes to my source code?

Yes, during the implementation phase, the skill will perform real work in your codebase to solve the specific task you've selected.

Do I need the OpenSpec CLI installed to use this skill?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project directory before you can begin the onboarding process.

How long does the onboarding walkthrough take?

A typical session takes approximately 15-20 minutes, allowing you to move from an idea to a fully implemented and archived change.

Can I use this skill on a project that hasn't started using OpenSpec?

You should run 'openspec init' first to set up the necessary directory structure, then this skill will guide you through your very first change cycle.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

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

This skill provides a hands-on, step-by-step introduction to the OpenSpec workflow within Claude Code. It helps developers move from an initial idea or codebase issue through the full lifecycle of software change—including exploration, proposal writing, specification drafting, technical design, and task implementation—culminating in an archived record of the work. By scanning the local repository for starter tasks like TODOs or missing tests, it ensures the learning experience happens on real code while providing safety rails for scope management.

Key Features

01Guided creation of standardized OpenSpec artifacts including proposals and specs

020 GitHub stars

03Interactive 11-phase walkthrough from initial concept to final archiving

04Automated codebase scanning for starter tasks like TODOs and missing tests

05Automatic change container management and historical documentation archiving

06Real-time implementation assistance with step-by-step narration

Use Cases

01Onboarding new team members to the OpenSpec development methodology

02Quickly addressing technical debt while establishing a professional documentation trail

03Learning how to use the OpenSpec CLI through a guided interactive session

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add blackbelttechnology/judo-runtime-core openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill