OpenSpec is a workflow methodology for managing software changes through structured artifacts like proposals, specs, design documents, and tasks.

How long does the onboarding process take?

The complete cycle typically takes 15-20 minutes, providing a rapid but thorough introduction to the workflow.

Can I pause the tutorial and finish later?

Absolutely. All progress is saved in the 'openspec/changes/' directory, allowing you to resume at any time using the continue command.

Do I need to install anything else?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project folder before use.

Does this skill make actual changes to my code?

Yes, as part of the onboarding, the skill will help you identify a real improvement in your codebase and guide you through implementing the fix.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: TomazWang

byTomazWang

0•

Learning & Documentation

Guides users through their first complete OpenSpec development cycle with interactive, real-world codebase tasks.

This skill provides a comprehensive, hands-on introduction to the OpenSpec workflow within Claude Code. It automates the teaching process by scanning your repository for improvement opportunities, helping you select a task, and walking you through the entire lifecycle—from initial exploration and proposal drafting to technical design, task implementation, and final archiving. It ensures developers understand the 'why' and 'how' of spec-driven development while performing actual, valuable work on their project.

Key Features

01Built-in guardrails to ensure starter tasks are appropriately scoped for learning

02Standardized archiving process for preserving project decision history

03Step-by-step guidance through the creation of proposals, specs, and design docs

04Automated codebase scanning for 'quick win' tasks like TODOs or missing tests

05Interactive implementation phase that links code changes to specific requirements

060 GitHub stars

Use Cases

01Learning how to bridge the gap between high-level requirements and technical implementation

02Introducing new team members to the OpenSpec methodology in a live project

03Standardizing documentation patterns for new software repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill