Do I need any external tools to use this skill?

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

What is the main purpose of the openspec-onboard skill?

It is designed to teach users the OpenSpec development cycle by walking them through a real task in their own codebase with step-by-step narration.

Does this skill modify my codebase?

Yes, during the 'Apply' phase, the skill helps you implement the planned changes and marks tasks as complete in your local files.

What kind of tasks does the onboarding process suggest?

The skill scans for TODO/FIXME comments, missing error handling, functions without tests, TypeScript 'any' types, and debug artifacts like console logs.

What happens to the work once the tutorial is finished?

The work is moved to an archive folder within your project, preserving the decision history and implementation details for future reference.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: ruan-cat

byruan-cat

•

学习与文档

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

The OpenSpec Onboarding skill provides a structured, hands-on tutorial for developers new to the OpenSpec workflow. It intelligently scans your current codebase for low-hanging fruit—such as TODOs, missing error handling, or type issues—and leads you through the entire lifecycle of a change. From initial exploration and proposal drafting to technical design and final implementation, this skill performs real work while explaining the rationale behind each artifact, transforming the learning process into a productive coding session.

主要功能

01Interactive walkthrough of the full OpenSpec lifecycle from Explore to Archive

02Intelligent scope guardrails to ensure tasks are appropriately sized for learning

03Step-by-step implementation guidance with real-time status updates

04Automated codebase scanning for starter tasks like TODOs and type issues

053 GitHub stars

06Automated generation of standardized artifacts including proposals and specs

使用场景

01Standardizing the change management process in a new or existing repository

02Onboarding new developers to a project's OpenSpec documentation standards

03Addressing technical debt while simultaneously learning a structured workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ruan-cat/monorepo openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill