Can I use this for large feature development?

While the OpenSpec workflow is designed for changes of all sizes, this onboarding skill specifically recommends starting with a small 'slice' to help you learn the rhythm of the framework quickly.

Will this skill make actual changes to my source code?

Yes. Unlike a theoretical tutorial, this skill helps you pick a real task in your current codebase and guides you through implementing the actual fix or feature.

What happens if I need to stop the tutorial halfway through?

OpenSpec saves all progress in the 'openspec/changes/' directory. You can stop at any time and resume later using the '/opsx:continue' command.

Do I need the OpenSpec CLI installed to use this skill?

Yes, this skill is a companion to the OpenSpec CLI. You must have the CLI installed and initialized in your project via 'openspec init' before starting the onboarding.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ValorVie

byValorVie

•

Learning & Documentation

Guides developers through their first full OpenSpec workflow cycle by implementing a real task in their codebase.

This skill provides an interactive, hands-on tutorial for the OpenSpec framework, helping developers transition from concept to implementation using a specification-driven approach. It automates codebase analysis to suggest 'quick win' tasks like fixing TODOs or adding missing tests, then walks the user through the creation of structured artifacts including proposals, specifications, and technical designs. By narrating the process of building, implementing, and archiving a real change, it ensures users master the OpenSpec lifecycle while making tangible improvements to their project.

Key Features

01Guided creation of the full OpenSpec artifact stack (Proposal, Specs, Design, Tasks)

02Interactive 'Explore Mode' for technical discovery and problem analysis

03Automated archival process to preserve project decision history and rationale

04Real-time implementation assistance linking design decisions to code changes

05Automated codebase scanning for small improvement opportunities and technical debt

063 GitHub stars

Use Cases

01Standardizing the documentation of small codebase improvements and bug fixes

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

03Onboarding new developers to the OpenSpec specification-driven development workflow

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