How does it find tasks to work on?

The skill performs a codebase analysis looking for TODO comments, missing error handling, functions without tests, and type issues like 'any' in TypeScript.

What happens to the documentation after implementation?

The skill includes an archive phase that moves your proposal, specs, and design documents into a dated archive folder, creating a permanent decision record for your project.

Can I use this for real development work?

Absolutely. While it functions as a tutorial, it performs real implementation and creates actual documentation within your repository's file structure.

Does this skill require any external tools?

Yes, it requires the OpenSpec CLI to be installed and initialized in your project repository to function correctly.

What is the OpenSpec Onboarding skill?

It is an interactive guide for Claude Code that teaches the OpenSpec methodology by walking you through a real code change from start to finish.

OpenSpec Onboarding

Name: OpenSpec Onboarding
Author: jaxxstorm

byjaxxstorm

•

Learning & Documentation

Guides developers through a complete OpenSpec workflow cycle using real codebase tasks and interactive narration.

OpenSpec Onboarding is a specialized Claude Code skill designed to teach developers the OpenSpec methodology through hands-on experience. It scans your local repository for improvement opportunities—such as TODOs, missing tests, or type issues—and leads you through the full development lifecycle: from drafting proposals and technical specifications to implementing code changes and archiving the decision history. This skill transforms the learning process into a productive session, ensuring developers master structured development workflows while shipping actual code improvements.

Key Features

0133 GitHub stars

02Interactive walkthrough of the Proposal-Spec-Design-Task development cycle

03Real-time implementation assistance with integrated status tracking

04Flexible interaction modes including guided learning and expert quick-reference

05Automated codebase scanning for TODOs, technical debt, and improvement opportunities

06Automated archival of change records to preserve project decision history

Use Cases

01Systematically addressing technical debt and TODOs while maintaining high-quality specs

02Improving project maintainability by creating a searchable history of architectural decisions

03Training new team members on standardized, documentation-driven development processes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jaxxstorm/sentinel openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill