Will this skill actually modify my source code?

Yes, during the 'Apply' phase, the skill will work with you to implement the actual code changes required to complete the selected task.

How long does the onboarding process take?

The interactive walkthrough is designed to take approximately 15-20 minutes to complete a full cycle.

Do I need to install any external tools?

Yes, this skill requires the openspec CLI to be installed and initialized in your project via 'openspec init'.

Can I use this for large feature development?

While the onboarding focuses on small tasks for learning, the workflow it teaches is scalable to large, complex features.

What is the OpenSpec workflow?

OpenSpec is a framework that structures code changes into artifacts: proposals (why), specs (what), design (how), and tasks (implementation steps).

OpenSpec Interactive Onboarding

Name: OpenSpec Interactive Onboarding
Author: durandom

bydurandom

0•

Learning & Documentation

Guides users through a complete OpenSpec development cycle by performing real codebase tasks and explaining each step.

The openspec-onboard skill serves as an interactive tutor for the OpenSpec framework, leading developers through a full documentation-driven development cycle. It begins by scanning your local codebase for 'quick win' tasks like TODOs or missing tests, then walks you through creating a change container, drafting proposals, defining testable specs, and implementing the code. This skill is ideal for teams or individuals looking to adopt a more structured approach to software changes without losing velocity.

Key Features

01Automated archiving of completed changes for project history

02Context-aware implementation support with real-time narration

03Interactive drafting of proposals, specs, and design documents

04Step-by-step guidance from task selection to implementation

05Automated codebase scanning for technical debt and TODOs

060 GitHub stars

Use Cases

01Onboarding new team members to the OpenSpec development workflow

02Implementing structured documentation-driven development patterns

03Systematically clearing technical debt and code TODOs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add durandom/layton openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill