How long does the onboarding process take?

The complete workflow cycle typically takes between 15 to 20 minutes, allowing you to see the full process from initial idea to archiving the completed work.

Does this skill require any external tools?

Yes, this skill requires the OpenSpec CLI to be installed and initialized in your project directory before you begin the onboarding process.

Will this skill actually modify my code?

Yes. Unlike a theoretical tutorial, this skill helps you pick a real task in your codebase and guides you through the actual implementation of that change.

What happens if I need to stop halfway through?

The skill handles exits gracefully. Your progress is saved within the OpenSpec directory in your project, and you can resume anytime using the /opsx:continue command.

OpenSpec is a structured workflow and CLI tool designed to manage software changes through specific artifacts like proposals, specs, design documents, and tasks.

OpenSpec Onboarding

Name: OpenSpec Onboarding
Author: carlosapgomes

bycarlosapgomes

0•

Learning & Documentation

Guides users through their first complete OpenSpec development cycle using real-world tasks within their own codebase.

The OpenSpec Onboarding skill provides a hands-on, interactive tutorial for mastering the OpenSpec workflow. It intelligently scans your codebase for improvements—such as TODOs, missing error handling, or untested functions—and leads you through every phase of the development lifecycle. From initial exploration and creating structured proposals to defining technical specs, designing implementation strategies, and archiving work for a permanent decision record, this skill ensures you learn by doing. It is an essential tool for developers and teams looking to standardize their documentation and implementation patterns using the OpenSpec methodology.

Key Features

01Automated generation of standardized markdown artifacts for proposals and specs

02Guided walkthrough of the full OpenSpec lifecycle from idea to archive

03Intelligent codebase scanning for actionable improvement opportunities

04Real-time implementation support with task-by-task narration

05Scope guardrails to ensure learning tasks remain manageable and effective

060 GitHub stars

Use Cases

01Learning to use the OpenSpec CLI through a guided, low-stakes project

02Establishing a standardized documentation habit for code changes

03Onboarding new team members to the OpenSpec development methodology

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add carlosapgomes/eqmd openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill