OpenSpec is a structured methodology and CLI tool for managing the software development lifecycle through artifacts like proposals, specifications, and designs.

Will this skill modify my source code?

Yes, as part of the onboarding process, the skill will help you pick a real task and implement the necessary code changes in your repository.

Does this skill require the OpenSpec CLI?

Yes, this skill requires the openspec CLI to be installed and initialized in your project before the onboarding can begin.

What happens if I stop the tutorial halfway through?

Your progress is saved within the OpenSpec 'change' container in your file system, allowing you to resume using the /opsx:continue command at any time.

How long does the onboarding process take?

The guided walkthrough is designed to take approximately 15-20 minutes to complete a full cycle from idea to implementation.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

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

Guides developers through a complete OpenSpec workflow cycle by identifying and implementing real codebase improvements with interactive narration.

This skill provides a hands-on, interactive introduction to the OpenSpec methodology, transforming the learning process into a productive coding session. It begins by scanning your codebase for 'quick wins' like TODO comments or missing tests, then leads you through the entire lifecycle of a code change—from drafting proposals and technical specifications to implementation and archiving. By performing real work while explaining the 'why' behind each artifact, it ensures developers master the OpenSpec CLI and its structured approach to software engineering within 20 minutes.

主な機能

010 GitHub stars

02Step-by-step narration of the OpenSpec workflow from exploration to archive

03Interactive drafting of Proposals, Specs, and Technical Design documents

04Automated codebase scanning to identify ideal starter tasks and improvements

05Real-time implementation assistance with task-based progress tracking

06Scope guardrails to ensure first-time tasks are manageable and educational

ユースケース

01Onboarding new developers to a team's OpenSpec-based development workflow

02Standardizing documentation practices for proposals and technical designs

03Learning the OpenSpec methodology by completing a real task in a new project

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