What happens to the documentation after the task is finished?

The skill guides you through the archiving process, which moves the artifacts to a permanent archive folder to preserve a historical record of the change.

What is the main goal of the OpenSpec Onboarding skill?

The main goal is to teach users the OpenSpec workflow—from proposal to implementation—by performing a real, small-scale task within their own codebase.

Do I need to have OpenSpec installed first?

Yes, the project must be initialized with 'openspec init' before the onboarding skill can run successfully.

Does this skill make permanent changes to my code?

Yes, the skill helps you implement a real task (like fixing a TODO or adding a test) and creates documentation files in an openspec/ directory.

How long does the onboarding process typically take?

The onboarding cycle usually takes between 15 to 20 minutes, depending on the complexity of the starter task selected.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: JasonY199

byJasonY199

0•

Learning & Documentation

Guides users through a complete OpenSpec development cycle by implementing a real task in their codebase with step-by-step narration.

The OpenSpec Onboarding skill provides a hands-on introduction to the OpenSpec workflow, transforming the way developers plan and implement changes. By scanning the local codebase for low-hanging fruit—such as TODOs, missing error handling, or untyped variables—it leads the user through the entire lifecycle of a code change: from initial exploration and proposal drafting to technical design, task breakdown, and final implementation. This skill is ideal for teams wanting to standardize their engineering practices, ensuring that every code change is backed by clear intent, precise specifications, and a preserved historical record of technical decisions.

Key Features

010 GitHub stars

02Integrated 'Explore' mode for architectural analysis before coding

03Real-time implementation support with task-by-task progress tracking

04Interactive walkthrough of the Proposal, Spec, and Design artifact creation

05Automated codebase scanning for starter tasks like TODOs and missing tests

06Automated archiving to build a permanent, searchable project decision history

Use Cases

01Teaching structured documentation habits for technical designs and requirements

02Standardizing the planning process for small features and architectural improvements

03Onboarding new developers to a team's OpenSpec-based engineering workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jasony199/jason-claude-plugins openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill