How long does the onboarding walkthrough take?

The complete cycle typically takes about 15-20 minutes, covering everything from task selection to final archiving.

What are the prerequisites for using this skill?

You must have the OpenSpec CLI installed and initialized (`openspec init`) in your project repository before starting the onboarding.

OpenSpec is a structured methodology for managing software changes through proposals, specifications, and designs before implementation to ensure clarity and quality.

Can I stop the tutorial and finish it later?

Absolutely. Your work is saved as a 'change' container in your project. You can resume at any time using the `/opsx:continue` or `/opsx:apply` commands.

Does this skill make actual changes to my code?

Yes. During the onboarding process, you will pick a real task (like fixing a TODO or adding a test) and the skill will help you implement it in your codebase.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

学習とドキュメンテーション

Guides developers through a complete OpenSpec workflow cycle by performing real codebase improvements while explaining each developmental phase.

This skill provides an interactive, hands-on tutorial for the OpenSpec methodology, transforming the learning process into productive work. It scans your codebase for 'quick wins' like TODOs, missing tests, or type issues, then leads you through the full lifecycle of a change—from initial exploration and requirement specification to technical design, implementation, and final archiving. By the end of the session, you will have completed a real task while mastering the 'why' and 'how' behind structured, spec-driven development.

主な機能

01Automated generation of standardized artifacts including proposals, specs, and design docs

020 GitHub stars

03Graceful state management to pause and resume onboarding sessions

04Real-time implementation assistance with narration linked to design decisions

05Automated codebase scanning for improvement opportunities and technical debt

06Interactive step-by-step guidance through the OpenSpec change lifecycle

ユースケース

01Learning how to use AI-driven specification and design to improve long-term code maintainability

02Establishing a rigorous development rhythm in a new or existing repository

03Onboarding new team members to a project using the OpenSpec development standard

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add blackbelttechnology/judo-generator-commons openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill