Does this skill require any external tools?

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

Is my progress saved if I stop midway?

Yes, all artifacts are saved to your local file system, allowing you to resume work using the /opsx:continue command at any time.

What is the primary goal of the OpenSpec Onboarding skill?

The skill is designed to teach users the OpenSpec workflow by walking them through a real-world code change cycle, from initial idea to final archival.

What files does this skill create in my repository?

It creates a structured directory under openspec/changes/ containing proposal.md, design.md, tasks.md, and detailed specification files.

Can I use this for large feature development?

While the workflow supports large features, the onboarding skill specifically recommends starting with small tasks (15-20 minutes) to learn the rhythm of the methodology first.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

Guides users through a complete OpenSpec development cycle from initial task identification to final implementation and archiving.

The OpenSpec Onboarder is a specialized teaching skill designed to master the OpenSpec methodology within a live codebase. It provides a structured, interactive experience that walks developers through the entire lifecycle of a code change—including exploration, proposal drafting, specification writing, technical design, and task implementation. By scanning for 'quick wins' like TODOs or missing error handling, it ensures users learn by doing real work while maintaining high standards for documentation and architectural discipline.

Key Features

01Interactive artifact generation for proposals, specs, and design documents

02Automated codebase scanning to identify ideal starter tasks and technical debt

030 GitHub stars

04Guided 'Explore Mode' for technical problem-solving before implementation

05Step-by-step task tracking with real-time progress updates in markdown

06Automatic archiving of completed changes to maintain project decision history

Use Cases

01Establishing a disciplined documentation-first approach for new projects

02Systematically addressing small codebase improvements and refactors

03Training new team members on standardized OpenSpec development workflows

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