What is the 'Archive' phase in the workflow?

Archiving moves completed changes to a historical folder, preserving the reasoning, specs, and design decisions for future reference and auditability.

Does this skill perform real changes to my code?

Yes, the onboarding skill identifies real tasks in your codebase and helps you implement them while explaining the OpenSpec workflow step-by-step.

Do I need the OpenSpec CLI installed?

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

Can I use this on a large existing project?

Absolutely. The skill scans your current project for small 'quick wins' like TODOs or missing validation to get you started without overwhelming complexity.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ValorVie

byValorVie

•

学習とドキュメンテーション

Guides users through a complete OpenSpec workflow cycle by performing real work on their codebase while narrating best practices.

The OpenSpec Onboarding skill provides a structured, hands-on introduction to the OpenSpec methodology within Claude Code. It automates the transition from initial problem exploration to final implementation and archiving, ensuring developers understand the 'why,' 'what,' and 'how' of every code change. By identifying real tasks in the local codebase—such as TODOs, missing error handling, or tech debt—it transforms the learning process into productive development time. This skill is essential for teams looking to standardize their technical decision-making and maintain a persistent, searchable history of their architectural evolution.

主な機能

01Automated codebase analysis to identify starter tasks like TODOs and missing tests

02Interactive drafting of requirement specifications using testable WHEN/THEN/AND scenarios

03Step-by-step guidance through the full OpenSpec lifecycle from Proposal to Archive

04Automatic archiving of completed changes to create a permanent project decision record

053 GitHub stars

06Real-time implementation narration that links code changes to original design decisions

ユースケース

01Learning how to document architectural decisions and technical requirements effectively

02Onboarding new developers to a project using the OpenSpec methodology

03Converting codebase technical debt into structured, manageable implementation tasks

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