What happens to the work I do during onboarding?

The changes you implement are real code updates, and the artifacts (proposals, specs, design) are saved and archived in your project's directory as a permanent record.

What is the OpenSpec Onboarding skill?

It is a specialized Claude Code capability that provides a guided, interactive tutorial for the OpenSpec methodology, helping you learn by doing real work in your codebase.

Does this skill require any external tools?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project directory before starting the onboarding process.

Can I pause the onboarding mid-way?

Yes, the skill is designed to save progress at every phase, allowing you to resume later using the standard OpenSpec commands mentioned in the guide.

How long does the onboarding process take?

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

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: TomazWang

byTomazWang

0•

Learning & Documentation

Guides users through their first complete OpenSpec workflow cycle by performing real work in their codebase while explaining each step.

The OpenSpec Onboarding Guide is a specialized pedagogical skill for Claude Code that transforms the learning of specification-driven development into a hands-on experience. Instead of reading documentation, users are guided through an 11-phase lifecycle that includes codebase analysis for 'quick wins,' creating formal proposals, defining technical specs, and implementing code changes. This skill bridges the gap between theory and practice, helping developers adopt a structured workflow for managing changes, documentation, and implementation tasks within their existing projects.

Key Features

01Automated codebase scanning to identify improvement opportunities like TODOs and missing tests

020 GitHub stars

03Structured artifact generation for proposals, specifications, and design documents

04Step-by-step implementation narration that links code changes to specific requirements

05Interactive multi-phase workflow covering everything from proposal to archiving

06Integrated guardrails to help users select appropriate task scopes for learning

Use Cases

01Setting up a structured change management process in a new or existing repository

02Learning how to write better technical specifications and design docs through AI guidance

03Onboarding developers to a team's OpenSpec-based development methodology

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill