Do I need any external tools for this skill?

Yes, this skill requires the OpenSpec CLI to be installed and initialized (`openspec init`) in your project directory to function.

What happens if I need to stop the tutorial mid-way?

Your progress is automatically saved in the `openspec/changes/` directory. You can resume at any time using the `/opsx:continue` or `/opsx:apply` commands.

OpenSpec is a framework for structured AI development that organizes work into 'changes' containing proposals, specs, designs, and tasks to ensure clear intent and implementation.

Will this skill make real changes to my code?

Yes, during the 'Apply' phase, the skill will implement the tasks you've defined together, making actual modifications to your project files.

Does this skill work with any programming language?

Yes, as long as the OpenSpec CLI is supported in your environment, this skill can analyze and modify codebases in any language.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ValorVie

byValorVie

•

Learning & Documentation

Guides developers through a complete OpenSpec workflow cycle using interactive narration and real codebase implementation.

This skill provides a hands-on, guided introduction to the OpenSpec methodology within Claude Code, helping developers master a structured approach to AI-driven development. It walks users through the entire lifecycle—from identifying a task and exploring the codebase to drafting proposals, specifications, and technical designs. By performing real work on the user's project, the skill teaches the 'Explore, New, Apply, Archive' rhythm, ensuring developers understand how to maintain a documented and reproducible development history while improving their code.

Key Features

013 GitHub stars

02Step-by-step artifact generation including Proposals, Specs, and Design documents

03Integrated OpenSpec CLI commands for change management and archiving

04Automated codebase scanning to identify 'quick win' tasks like TODOs and missing tests

05Scope guardrails to ensure onboarding tasks remain manageable for beginners

06Real-time implementation of code changes based on defined task lists

Use Cases

01Setting up and learning the OpenSpec workflow for the first time in a new project

02Training team members on standardized, documentation-first AI development patterns

03Resolving technical debt while establishing a structured development history

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add valorvie/custom-skills openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill