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

学习与文档

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.

主要功能

Interactive artifact generation for proposals, specs, and design documents
Automated codebase scanning to identify ideal starter tasks and technical debt
0 GitHub stars
Guided 'Explore Mode' for technical problem-solving before implementation
Step-by-step task tracking with real-time progress updates in markdown
Automatic archiving of completed changes to maintain project decision history

使用场景

Establishing a disciplined documentation-first approach for new projects
Systematically addressing small codebase improvements and refactors
Training 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

GitHub

关于