How does the skill find tasks to work on?

The skill scans your files for TODO/FIXME comments, missing error handling, functions without tests, and type issues to suggest manageable starter tasks.

Will this skill modify my files?

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

What happens to the documentation after the task is finished?

The skill uses the OpenSpec archive command to move the proposal, specs, and design documents into a dated archive folder, creating a permanent history of the change.

Does this skill require external tools?

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

What is the primary purpose of the OpenSpec Onboarding skill?

It is designed to teach users the OpenSpec methodology by walking them through a real-world task in their own codebase, covering everything from planning to archiving.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: twilwa

bytwilwa

0•

Learning & Documentation

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

The OpenSpec Onboarding skill provides an interactive, hands-on tutorial for the OpenSpec framework, helping developers transition from a code-first approach to a structured, spec-first methodology. It identifies real tasks in your current project—such as missing error handling or TODO comments—and walks you through the entire lifecycle of a change: from drafting proposals and technical specs to implementation and final archiving. This skill is ideal for teams looking to standardize their development process and maintain a clear, documented history of every architectural decision.

Key Features

01Integrated 'Explore Mode' for technical discovery and problem analysis

02Live implementation support with real-time task tracking and checkbox management

03Interactive walkthrough for creating proposals, specs, and design documents

04Automated codebase scanning to identify ideal 'quick win' starter tasks

050 GitHub stars

06Automated archiving to preserve project decision history and documentation

Use Cases

01Transitioning a project from informal coding to a structured documentation-first workflow

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

03Cleaning up technical debt by systematically addressing TODOs and missing tests

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add twilwa/the-revenger openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill