Can I use this for large features?

While the OpenSpec workflow supports large changes, this specific onboarding skill is optimized for small, 15-20 minute tasks to help you learn the rhythm of the process.

Do I need the OpenSpec CLI installed?

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

OpenSpec is a structured workflow for software development that uses standardized artifacts like proposals, specs, and designs to manage changes and preserve project history.

Does this skill make actual changes to my code?

Yes, during the 'Apply' phase of the onboarding, the skill will help you implement real code changes based on the tasks you identified and specified together.

What happens if I need to stop the tutorial mid-way?

The skill handles graceful exits by saving your progress in the openspec/changes/ directory, allowing you to resume using the /opsx:continue command later.

OpenSpec Guided Onboarder

Name: OpenSpec Guided Onboarder
Author: ValorVie

byValorVie

•

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

Provides a narrated, step-by-step onboarding experience for the OpenSpec workflow directly within your codebase.

The OpenSpec Onboard skill bridges the gap between theory and practice by guiding developers through their first complete OpenSpec change cycle. It automates the discovery of suitable starter tasks—such as fixing TODOs or adding missing tests—and then leads the user through the structured phases of exploration, proposal creation, specification, design, task breakdown, implementation, and archiving. By performing real work while explaining the logic behind each artifact, it ensures users master the OpenSpec methodology through hands-on experience in their own development environment.

主な機能

013 GitHub stars

02Guided creation of standardized OpenSpec artifacts including Proposals, Specs, and Design documents

03Real-time implementation assistance with narration linked to defined specifications

04Interactive 'Explore Mode' for technical investigation and ASCII diagramming

05Automated codebase scanning to identify ideal 'quick win' starter tasks

06Integrated archiving process to preserve project decision history and technical debt records

ユースケース

01Onboarding new team members to a project using the OpenSpec methodology

02Learning the OpenSpec CLI through a hands-on, low-risk codebase improvement

03Standardizing the transition from technical debt discovery to implementation for small maintenance 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