What happens to the OpenSpec files after I finish a task?

When a change is completed, the skill guides you through archiving it. This moves the documentation to an archive folder, preserving your project's decision history for future reference.

How long does the onboarding take?

The typical walkthrough takes about 15-20 minutes, depending on the complexity of the starter task you select from the suggestions provided.

Do I need the OpenSpec CLI installed?

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

OpenSpec is a structured development methodology that uses a specific artifact-driven workflow (proposals, specs, design, and tasks) to document the rationale and implementation of every code change.

Does this skill make actual changes to my code?

Yes, the onboarding process involves picking a real, small task in your codebase and implementing it together to demonstrate how OpenSpec integrates with actual development work.

OpenSpec Onboarding

Name: OpenSpec Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Aprendizaje y Documentación

Guides users through their first complete OpenSpec development cycle with interactive narration and real codebase tasks.

The OpenSpec Onboarding skill provides a hands-on, interactive tutorial for developers looking to adopt the OpenSpec workflow within Claude Code. It moves beyond simple documentation by scanning your specific codebase for real improvement opportunities, then walking you through the entire lifecycle of a 'change'—from initial exploration and requirement specification to technical design, implementation, and final archiving. This skill is ideal for teams and individuals who want to formalize their development process and maintain a clear, traceable history of technical decisions directly within their repository.

Características Principales

01Step-by-step guidance through OpenSpec artifact creation including Proposals and Specs.

02Automated archiving to preserve project decision history and technical context.

03Interactive 'Explore Mode' for technical investigation before writing code.

040 GitHub stars

05Automated codebase scanning to identify low-hanging fruit like TODOs and type issues.

06Task-based implementation tracking that links code changes to design requirements.

Casos de Uso

01Onboarding new developers to the OpenSpec methodology within an existing project.

02Establishing a structured, documented workflow for small-to-medium codebase improvements.

03Learning how to use the OpenSpec CLI for better requirement and design management.

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