Does this skill require external tools?

Yes, this skill requires the openspec-cn CLI tool to be installed and initialized in your local repository.

What is the OpenSpec workflow?

OpenSpec is a structured development methodology that moves from exploration to proposals, specifications, and design before implementation and archiving.

Will this skill modify my actual code?

Yes, during the 'Apply' phase of the onboarding, the skill will help you implement real changes to the files in your repository based on the task you chose.

How long does the onboarding process take?

A typical session takes between 15 to 20 minutes to walk through a complete cycle from identifying a task to archiving the finished work.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: HerbertGao

byHerbertGao

•

Learning & Documentation

Guides developers through the full OpenSpec workflow cycle by completing a real task within their own codebase.

This skill provides an interactive, hands-on tutorial for OpenSpec, a structured development methodology designed to improve code quality and documentation. It walks users through the entire lifecycle of a code change—from identifying small improvements and drafting technical proposals to creating specifications, designing solutions, and executing tasks. By using real code from the user's repository rather than abstract examples, it ensures developers learn the practical application of maintaining a disciplined, document-driven development process with Claude.

Key Features

01Interactive technical design drafting and trade-off analysis

02Step-by-step guidance for creating technical proposals and specifications

03Automatic archiving of changes to maintain a clean project decision history

04Automated codebase scanning for improvement opportunities like TODOs or missing tests

05Structured task breakdown and real-time implementation tracking

061 GitHub stars

Use Cases

01Standardizing the transition from a 'quick fix' idea to a fully documented code change

02Learning the OpenSpec methodology through direct application on existing repository issues

03Onboarding new developers to a project's specific documentation and workflow standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertgao/qsl-cardhub openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill