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 correctly.

OpenSpec is a structured methodology and CLI tool for managing the lifecycle of a code change, emphasizing clear documentation and specifications before implementation begins.

Does this skill work on real code?

Yes. Unlike generic tutorials, this skill scans your actual codebase for TODOs or missing tests and performs real work on your files as part of the learning process.

How long does the onboarding session take?

The complete workflow cycle—from selecting a task to archiving the finished code—typically takes between 15 and 20 minutes.

Can I stop the tutorial mid-way?

Absolutely. Your progress is saved in the `openspec/changes/` directory, and you can resume implementation at any time using the `/opsx-continue` or `/opsx-apply` commands.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ValorVie

byValorVie

•

Learning & Documentation

Guides developers through a complete OpenSpec workflow cycle to master structured, document-driven AI development.

The OpenSpec Onboarding skill provides an interactive, hands-on tutorial for the OpenSpec methodology within the Claude Code environment. It automates the process of identifying real-world improvement opportunities in your codebase and leads you through every stage of the development lifecycle—from initial exploration and proposal drafting to technical design, task breakdown, implementation, and final archiving. It is the ideal starting point for developers who want to move beyond simple code generation toward a disciplined, specification-first engineering process that preserves decision history.

Key Features

01Synchronized implementation that checks off tasks and references specifications in real-time.

023 GitHub stars

03Automated archiving process to maintain a permanent record of project decisions.

04Live demonstration of 'Explore Mode' for pre-implementation analysis.

05Interactive walkthrough of the full OpenSpec artifact lifecycle (Proposal, Specs, Design, Tasks).

06Automated codebase scanning to suggest low-risk 'quick win' tasks for learning.

Use Cases

01Establishing a standardized documentation and implementation rhythm in a new repository.

02Onboarding new developers to a project using the OpenSpec methodology.

03Learning how to transition from ad-hoc coding to structured AI-assisted engineering.

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