Does this skill perform real changes to my code?

Yes. During the onboarding process, Claude will help you identify a real task in your codebase and guide you through implementing the fix or feature using the OpenSpec methodology.

Can I use this skill to resume an existing change?

While this specific skill is for onboarding, the OpenSpec workflow it teaches includes commands like /opsx:continue and /opsx:apply to resume work at any time.

Do I need to install the OpenSpec CLI first?

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

OpenSpec is a development workflow and CLI tool designed to structure the coding process using standardized artifacts like proposals, specs, and design documents to maintain a clear decision history.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ValorVie

byValorVie

•

Learning & Documentation

Guides users through a complete OpenSpec development cycle with interactive narration and real codebase implementation.

The OpenSpec Onboarding skill provides a hands-on, interactive tutorial for mastering the OpenSpec workflow directly within your repository. It bridges the gap between theory and practice by identifying real improvement opportunities—such as TODOs, missing tests, or type issues—and walking you through every phase of the development lifecycle: from initial exploration and proposal drafting to technical design, task implementation, and final archiving. This skill ensures developers understand how to document the 'why' and 'how' of their changes, creating a persistent decision history while simultaneously shipping functional code in a structured, AI-enhanced environment.

Key Features

01Guided implementation phase with real-time narration and task tracking

02Standardized requirement formatting using WHEN/THEN/AND scenarios

03Automated codebase scanning for quick-win tasks like TODOs and missing validation

043 GitHub stars

05Interactive Explore Mode for architectural investigation and ASCII diagramming

06Step-by-step walkthrough of the OpenSpec artifact lifecycle including proposals and specs

Use Cases

01Learning how to structure technical requirements and design decisions in an AI-assisted workflow

02Cleaning up technical debt while building a structured, searchable project history

03Onboarding new developers to a team's OpenSpec-based documentation and development standards

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