Can I use this on an existing project?

Absolutely. The skill is designed to scan your current codebase for TODOs, bugs, or missing types to find a relevant task for the onboarding tutorial.

Do I need the OpenSpec CLI to use this skill?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project directory to perform its core functions.

What happens if I need to stop the tutorial midway?

Your work is saved in the openspec/changes/ directory. You can resume at any time using the /opsx:continue or /opsx:apply commands.

Does this skill actually change my code?

Yes, during the implementation phase, the skill will help you write and modify code to complete the tasks defined during the planning phase.

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

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: TomazWang

byTomazWang

0•

Learning & Documentation

Guides developers through a complete OpenSpec workflow cycle to master specification-driven development within their own codebase.

The OpenSpec Onboard skill provides a hands-on, narrated introduction to the OpenSpec development methodology. It assists users in identifying real improvement opportunities—such as technical debt, missing tests, or unhandled errors—and leads them through the entire lifecycle of a change. From drafting proposals and technical specifications to implementation and archiving, this skill ensures developers learn the rhythm of specification-driven development by doing real work in their project while building a permanent record of technical decisions.

Key Features

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

02Narrated implementation phase that syncs code changes with defined requirements.

030 GitHub stars

04Built-in scope guardrails to ensure learning tasks are manageable for beginners.

05Structured archiving process to preserve project history and architectural decisions.

06Interactive drafting of standardized proposals, specs, designs, and task lists.

Use Cases

01Standardizing documentation for requirements and design decisions in any repository.

02Onboarding new developers to a team's specification-driven development standards.

03Systematically tackling small codebase improvements while learning a new workflow.

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