OpenSpec is a framework for managing software changes through structured documentation, providing a clear path from initial proposal to implementation and archiving.

How long does the onboarding process take?

The guided walkthrough is designed to take approximately 15-20 minutes while you perform a real improvement task in your codebase.

What happens to the work created during onboarding?

The changes are committed to your codebase and the documentation is archived within your project's local directory, forming a permanent record of the work.

Does this skill require external tools?

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

Can I use this for major feature development?

While the workflow supports major features, the onboarding skill includes a 'scope guardrail' that recommends starting with a small task to learn the rhythm efficiently.

OpenSpec Guided Onboarding

Name: OpenSpec Guided Onboarding
Author: TomazWang

byTomazWang

•

Learning & Documentation

Guides users through a complete OpenSpec workflow cycle to master AI-driven change management and documentation.

This skill provides an interactive, narrated walkthrough of the OpenSpec framework, helping developers transition from exploring a codebase to successfully implementing and archiving changes. It automates the creation of critical artifacts—including proposals, specifications, and design documents—while teaching the structured 'think before you code' philosophy required for maintaining healthy brownfield projects. By performing real work on your codebase during the tutorial, you learn how to use OpenSpec to create a permanent record of technical decisions and implementation details.

Key Features

01Automated codebase scanning for task suggestions (TODOs, bugs, missing tests)

02Step-by-step creation of OpenSpec artifacts including Proposal, Spec, and Design

03Automated archiving to preserve project decision history and knowledge

041 GitHub stars

05Interactive exploration mode for visual and logical problem analysis

06Real-time implementation guidance with spec-to-code mapping

Use Cases

01Onboarding new developers to a project using the OpenSpec workflow

02Establishing a structured maintenance rhythm for complex brownfield projects

03Learning how to structure technical documentation for AI-assisted coding

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/deepfield openspec-onboard

For use in Claude.ai and ChatGPT

Key Features

01Automated codebase scanning for task suggestions (TODOs, bugs, missing tests)

02Step-by-step creation of OpenSpec artifacts including Proposal, Spec, and Design

03Automated archiving to preserve project decision history and knowledge

041 GitHub stars

05Interactive exploration mode for visual and logical problem analysis

06Real-time implementation guidance with spec-to-code mapping

Use Cases

01Onboarding new developers to a project using the OpenSpec workflow

02Establishing a structured maintenance rhythm for complex brownfield projects

03Learning how to structure technical documentation for AI-assisted coding

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/deepfield openspec-onboard

For use in Claude.ai and ChatGPT