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

Learning & Documentation

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

About

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

Guided drafting of structured proposals, specifications, and design docs
Interactive step-by-step guidance through the full OpenSpec change cycle
0 GitHub stars
Automated archiving to preserve project decision history and rationale
Task-based implementation tracking with real-time status updates
Automated codebase scanning for TODOs, type issues, and missing tests

Use Cases

Executing small codebase refactors or bug fixes with complete traceability
Learning structured software design and documentation patterns by doing
Onboarding 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

GitHub