How long does the guided onboarding take?

The complete cycle typically takes between 15 and 20 minutes, depending on the complexity of the task you choose to work on.

Does this skill require the OpenSpec CLI?

Yes, this skill is a companion to the OpenSpec CLI. You must have the CLI installed and initialized in your project to use the onboarding features.

OpenSpec is a CLI-driven workflow for structured software development that emphasizes creating clear artifacts like proposals, specs, and designs before implementation.

Can I pause the onboarding process?

Yes. The skill handles graceful exits and saves your progress in the 'openspec/changes/' directory, allowing you to resume later using the continue command.

Will this skill make real changes to my code?

Yes. During the implementation phase, the skill will help you write and modify real code in your repository based on the tasks defined during the walkthrough.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: MichaelvanLaar

byMichaelvanLaar

•

Learning & Documentation

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

The OpenSpec Onboarding skill is an interactive teaching tool designed to help developers master the OpenSpec workflow directly within their own codebase. It provides a structured, step-by-step journey through the entire development lifecycle—from initial problem exploration and artifact creation (proposals, specs, and design) to implementation and final archiving. By identifying small, actionable tasks like fixing TODOs or improving error handling, the skill ensures that users learn the value of documentation-driven development through practical, hands-on experience rather than theory alone.

Key Features

01Built-in guardrails to ensure manageable task scoping

02Automated codebase scanning to identify ideal starter tasks

03Interactive drafting of proposals, technical specs, and design docs

043 GitHub stars

05Narrated implementation phase with real-time task tracking

06Complete workflow automation using the OpenSpec CLI

Use Cases

01Setting up structured change management in a new repository

02Learning the discipline of artifact-driven development workflows

03Onboarding new developers to an OpenSpec-managed project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add michaelvanlaar/mvlkss openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill