What are the prerequisites for using openspec-onboard?

You must have the OpenSpec CLI installed and initialized in your project using 'openspec init' before starting the onboarding skill.

Where are the OpenSpec artifacts stored?

All artifacts (proposals, designs, specs, and tasks) are stored within an 'openspec/' directory in your project root, creating a permanent record of technical decisions.

Does this skill work on any repository?

Yes, provided you have the OpenSpec CLI installed. The skill will scan your current codebase to find relevant tasks to work on during the tutorial.

How long does the guided onboarding take?

The complete cycle typically takes 15-20 minutes, covering everything from task selection to final implementation and archiving.

What is the OpenSpec workflow?

OpenSpec is a structured development methodology that uses standardized markdown artifacts—proposals, specs, and designs—to manage the lifecycle of a code change from concept to archive.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: mance-cyber

bymance-cyber

0•

Learning & Documentation

Guides developers through their first complete OpenSpec workflow cycle with interactive, real-world codebase tasks.

OpenSpec Onboarding is a specialized skill designed to teach the OpenSpec development methodology through hands-on practice. It goes beyond theoretical documentation by scanning your actual codebase for improvement opportunities—such as TODOs, missing tests, or type issues—and walking you through the structured lifecycle of a change. From initial exploration and proposal drafting to technical design, task breakdown, and final implementation, this skill ensures developers understand how to maintain a rigorous decision history and high-quality implementation standards using the OpenSpec CLI.

Key Features

010 GitHub stars

02Automated codebase scanning to identify 'quick win' tasks and technical debt.

03Step-by-step walkthrough of the OpenSpec lifecycle: Proposal, Spec, Design, and Tasks.

04Smart scope guardrails to ensure learning tasks are appropriately sized for the workflow.

05Interactive implementation assistance with narration linked to design specifications.

06Structured change management including automated archiving for project history.

Use Cases

01Standardizing documentation and workflow patterns in a new or existing repository.

02Onboarding new team members to the OpenSpec development methodology and standards.

03Learning how to decompose complex features into testable specifications and actionable implementation tasks.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mance-cyber/ggj_hktvmall_mms openspec-onboard

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Automated codebase scanning to identify 'quick win' tasks and technical debt.

03Step-by-step walkthrough of the OpenSpec lifecycle: Proposal, Spec, Design, and Tasks.

04Smart scope guardrails to ensure learning tasks are appropriately sized for the workflow.

05Interactive implementation assistance with narration linked to design specifications.

06Structured change management including automated archiving for project history.

Use Cases

01Standardizing documentation and workflow patterns in a new or existing repository.

02Onboarding new team members to the OpenSpec development methodology and standards.

03Learning how to decompose complex features into testable specifications and actionable implementation tasks.