OpenSpec is a structured workflow and CLI tool designed to manage software changes through clear artifacts like proposals, requirements (specs), and technical designs.

What happens to the work I do during onboarding?

All code changes remain in your project, and the generated documentation is moved to an archive folder, providing a permanent record of the work.

How long does the onboarding tutorial take?

A typical walkthrough takes approximately 15-20 minutes, depending on the complexity of the task selected for the demo.

What are the prerequisites for using this skill?

You must have the openspec CLI installed and have already run 'openspec init' in your project directory.

Does this skill perform real work on my code?

Yes, the onboarding skill scans your specific codebase for tasks and helps you implement real changes while explaining the OpenSpec process.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

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

Guides users through their first complete OpenSpec workflow cycle by implementing real codebase improvements with step-by-step narration.

OpenSpec Guided Onboarding is a specialized skill designed to teach developers the OpenSpec methodology by doing real work. It automates the process of identifying codebase improvements—such as technical debt or missing tests—and leads the user through the entire lifecycle: from creating a 'change' container and drafting proposals, specs, and designs, to final implementation and archiving. This skill is ideal for teams adopting OpenSpec who want a hands-on, interactive tutorial that results in actual code quality improvements while establishing best practices for technical documentation.

主な機能

01Interactive walkthrough of the Proposal-Spec-Design-Task lifecycle

02Automated archiving of completed changes for decision history

03Automated codebase scanning for TODOs and improvement opportunities

040 GitHub stars

05Real-time generation of structured Markdown artifacts

06Narration-guided implementation and task tracking

ユースケース

01Onboarding new developers to a project's specific OpenSpec workflow

02Systematically addressing technical debt using a structured process

03Learning how to write precise technical specifications and design docs

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

主な機能

01Interactive walkthrough of the Proposal-Spec-Design-Task lifecycle

02Automated archiving of completed changes for decision history

03Automated codebase scanning for TODOs and improvement opportunities

040 GitHub stars

05Real-time generation of structured Markdown artifacts

06Narration-guided implementation and task tracking

ユースケース

01Onboarding new developers to a project's specific OpenSpec workflow

02Systematically addressing technical debt using a structured process

03Learning how to write precise technical specifications and design docs

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