How long does the onboarding tutorial take?

The complete cycle is designed to be a focused learning experience that typically takes between 15 and 20 minutes.

What is the primary purpose of the openspec-onboard skill?

It is designed to teach users the OpenSpec workflow by guiding them through a real-world change cycle—from initial idea to documentation and final implementation.

Can I stop the onboarding process and resume later?

Absolutely. The skill saves your progress in the 'openspec/changes' directory, allowing you to resume later using the continue or apply commands.

Does this skill require external tools?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project repository to function correctly.

Will this skill modify my source code?

Yes, during the 'Apply' phase of the onboarding, the skill will implement the selected task directly in your codebase based on the specs created.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: ValorVie

byValorVie

•

Learning & Documentation

Teaches the complete OpenSpec workflow through a hands-on, narrated implementation of a real task in your codebase.

This skill provides a structured, interactive introduction to the OpenSpec development methodology within Claude Code. It automates the process of identifying 'quick win' improvements in your project—such as resolving TODOs or adding missing error handling—and guides you through the entire lifecycle of a change. By walking through the creation of proposals, specifications, and designs before implementation, it helps developers master a disciplined, documentation-first approach to AI-assisted coding that preserves project history and architectural intent.

Key Features

013 GitHub stars

02Automated codebase scanning for improvement opportunities like TODOs and type issues.

03Interactive generation of standardized artifacts including proposals, specs, and designs.

04Automatic archiving of completed changes to maintain a clean project decision history.

05Step-by-step narration of the OpenSpec lifecycle from exploration to archiving.

06Real-time implementation of code changes driven directly by defined task lists.

Use Cases

01Onboarding new team members to standardized AI-assisted development workflows.

02Establishing a rigorous documentation habit for small bug fixes and feature enhancements.

03Learning how to leverage specification-driven development within Claude Code.

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