How long does the onboarding process take?

A typical walkthrough takes approximately 15-20 minutes, covering everything from task selection to final archiving.

Can I use this for large feature development?

While the workflow supports large features, the onboarding skill specifically includes guardrails to suggest smaller tasks so you can learn the full cycle quickly.

Does this skill make actual changes to my code?

Yes. During the implementation (Apply) phase, the skill will perform real work in your codebase to complete the task you selected during onboarding.

OpenSpec is a structured workflow framework that organizes code changes into a cycle of proposal, specification, design, implementation, and archiving to ensure long-term maintainability.

Do I need the OpenSpec CLI installed?

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

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: moredip

bymoredip

•

Learning & Documentation

Guides users through a complete OpenSpec development cycle from initial task discovery to implementation and archiving.

OpenSpec Onboarding is a specialized skill designed to teach developers the OpenSpec workflow by performing real work within their own codebase. It automates the process of identifying small improvement opportunities—such as TODOs, missing error handling, or untested functions—and then walks the user through a structured 'documentation-first' cycle. By guiding you through the creation of proposals, testable specifications, and technical designs before implementation, it ensures every code change is well-reasoned, documented, and permanently recorded in your project's history.

Key Features

01Automated codebase scanning for 'quick win' improvement opportunities

02Integrated 'Explore' mode for pre-implementation architectural analysis

032 GitHub stars

04Interactive drafting of Proposals, Specs, and Design documents

05Structured archiving of changes to preserve project decision records

06Guided implementation phase with task-by-task narration

Use Cases

01Systematically addressing technical debt and TODOs in a new codebase

02Learning the OpenSpec workflow through a hands-on, narrated tutorial

03Onboarding developers to a standardized, documentation-heavy engineering culture

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add moredip/session-share openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill