Can I use this on a live production codebase?

Yes, the skill is designed to work on your actual codebase, identifying real tasks so you can learn the workflow while performing productive work.

Do I need any external tools to use this skill?

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

Is the task selection automated?

The skill scans your code for suggestions (like TODOs or missing error handling), but you maintain full control over which task to implement or can define your own.

What happens if I need to pause the onboarding process?

The skill handles exits gracefully. 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 primary goal of the openspec-onboard skill?

The primary goal is to teach developers the OpenSpec methodology by walking them through a real-world code change from initial discovery to final archiving.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

Guides users through a complete OpenSpec workflow cycle using interactive narration and real-world codebase tasks.

OpenSpec Onboard is an interactive teaching experience designed to familiarize developers with the OpenSpec methodology directly within their terminal. Instead of passive reading, this skill transforms the learning process into an active development session by helping users identify real improvement opportunities in their codebase, such as technical debt or missing tests. It leads the user through the entire 'Explore-to-Archive' pipeline—including drafting proposals, technical specifications, and design documents—ensuring they understand the structural discipline required for high-quality software implementation while making tangible progress on their project.

Key Features

01Guided drafting of structured proposals, specifications, and design docs

02Interactive step-by-step guidance through the full OpenSpec change cycle

030 GitHub stars

04Automated archiving to preserve project decision history and rationale

05Task-based implementation tracking with real-time status updates

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

Use Cases

01Executing small codebase refactors or bug fixes with complete traceability

02Learning structured software design and documentation patterns by doing

03Onboarding developers to a team using the OpenSpec methodology

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