Does this skill make real changes to my code?

Yes, during the implementation phase, the skill helps you perform actual work in your codebase based on the tasks defined during the onboarding process.

How long does the onboarding process take?

The complete cycle, from identifying a small task to archiving the finished work, typically takes about 15-20 minutes.

Are there any prerequisites for using this skill?

Yes, you must have the OpenSpec CLI installed and the project must be initialized using the 'openspec init' command before starting the onboarding.

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

Your progress is saved in the openspec/changes/ directory. You can resume later using the /opsx:continue or /opsx:apply commands provided by the plugin.

OpenSpec is a workflow framework that organizes code changes into structured 'changes' containing proposals, specifications, and design documents for better maintainability and historical context.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: vtakaj

byvtakaj

0•

Learning & Documentation

Guides developers through a complete specification-driven development cycle using real codebase tasks and narrated instructions.

The OpenSpec Onboarding skill provides a hands-on, interactive tutorial for mastering the OpenSpec workflow directly within your repository. It helps users identify improvement opportunities like technical debt or missing tests, then leads them through a structured development process: from drafting proposals and technical specs to designing solutions and implementing tasks. By narrating each step and automating the creation of change containers, this skill teaches best practices for maintaining a transparent and documented decision history while performing real engineering work.

Key Features

01Step-by-step artifact generation for proposals, specs, and design documents

02Interactive Explore Mode for technical discovery and architectural visualization

030 GitHub stars

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

05Automated codebase scanning for starter tasks like TODOs and missing error handling

06Automated archiving of completed changes to preserve project decision history

Use Cases

01Learning specification-driven development by applying it to real codebase issues

02Standardizing the process of documenting why and how technical decisions are made

03Onboarding new team members to a project's specific development standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vtakaj/ado-history openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill