OpenSpec is a structured framework for specification-driven development (SDD) that ensures technical decisions, requirements, and implementation tasks are documented and versioned alongside your code.

Does this skill require external tools?

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

What happens to the documents created during onboarding?

All artifacts (proposals, specs, and designs) are saved in an 'openspec/' directory within your repository and are archived into your project history once the task is complete.

Will this skill make changes to my source code?

Yes, as part of the guided tour, the skill will help you select a small real-world task in your codebase and then implement the necessary code changes to demonstrate the full workflow.

OpenSpec Interactive Onboarding

Name: OpenSpec Interactive Onboarding
Author: bcl1713

bybcl1713

0•

Learning & Documentation

Guides developers through a complete specification-driven development cycle using the OpenSpec framework on their own codebase.

OpenSpec Onboarding is a specialized teaching skill designed to transition developers from ad-hoc coding to a structured, specification-driven workflow. It provides a narrated, hands-on experience where Claude identifies improvement opportunities in your existing code, helps you draft technical artifacts—including proposals, specs, and designs—and then executes the implementation. This skill is ideal for teams adopting the OpenSpec methodology or individuals looking to improve their technical planning and documentation habits within their version-controlled projects.

Key Features

010 GitHub stars

02Real-time codebase implementation with step-by-step narration and task tracking

03Automated codebase scanning for TODOs and missing error handling to identify starter tasks

04Automated archiving of completed changes to preserve a searchable decision history

05Guided creation of OpenSpec artifacts including Proposal, Specs, Design, and Tasks

06Interactive 'Explore Mode' for technical discovery and problem-solving before implementation

Use Cases

01Learning the OpenSpec CLI commands through a practical, narrated tutorial

02Setting up the initial OpenSpec workflow structure for a new or existing repository

03Training team members on specification-driven development (SDD) best practices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bcl1713/couch-to-5k openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill