What are the prerequisites for using this skill?

You must have the OpenSpec CLI installed and initialized in your repository before starting the onboarding process.

OpenSpec is a structured workflow framework that uses markdown artifacts—Proposals, Specs, Design, and Tasks—to document the purpose and implementation details of code changes.

Does this skill perform real work on my code?

Yes. Unlike a static tutorial, this skill helps you select a real task in your codebase and guides you through implementing it using the OpenSpec methodology.

How does the archiving process work?

Once a change is implemented, the skill moves the documentation from the active changes folder to an archive, creating a permanent history of project decisions.

OpenSpec Onboarding Guide

Name: OpenSpec Onboarding Guide
Author: TomazWang

byTomazWang

•

학습 및 문서화

Guides users through a complete OpenSpec development cycle by performing real work in their codebase while explaining documentation best practices.

The OpenSpec Onboarding skill is an interactive tutorial designed to teach developers the OpenSpec workflow—a structured approach to software changes. It moves from initial problem exploration and proposal drafting to technical design, task generation, and implementation. By scanning the local codebase for real improvement opportunities like TODOs or missing tests, the skill provides a hands-on experience that transforms a conceptual framework into actionable development habits while maintaining a permanent record of technical decisions.

주요 기능

01Automated codebase scanning for small, manageable improvement opportunities

02Guided creation of standardized artifacts including Proposals, Specs, and Designs

03Step-by-step implementation tracking with real-time narration and task management

04Interactive 'Explore Mode' for pre-implementation technical analysis

051 GitHub stars

06Automated archiving of completed changes to build a searchable project history

사용 사례

01Training new developers on project-specific documentation and workflow standards

02Establishing a clear decision-log for small features and bug fixes in brownfield projects

03Transitioning from informal coding to a structured, spec-driven development process

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/deepfield openspec-onboard

For use in Claude.ai and ChatGPT

주요 기능

01Automated codebase scanning for small, manageable improvement opportunities

02Guided creation of standardized artifacts including Proposals, Specs, and Designs

03Step-by-step implementation tracking with real-time narration and task management

04Interactive 'Explore Mode' for pre-implementation technical analysis

051 GitHub stars

06Automated archiving of completed changes to build a searchable project history

사용 사례

01Training new developers on project-specific documentation and workflow standards

02Establishing a clear decision-log for small features and bug fixes in brownfield projects

03Transitioning from informal coding to a structured, spec-driven development process