Does this skill help with documentation?

Yes, it automates the drafting of project history, including why a change was made (Proposal) and how it should behave (Specs).

OpenSpec is a structured development methodology and CLI tool that focuses on creating clear artifacts like proposals, specs, and designs before implementation.

Can I use this for real project work?

Absolutely. While it is an onboarding experience, it performs real work on your codebase, resulting in a fully implemented and archived change.

Does this skill require the OpenSpec CLI?

Yes, this skill is a companion to the OpenSpec CLI. You must have it installed and run 'openspec init' in your project before starting the onboarding.

What happens if I need to stop the tutorial midway?

All progress is saved in the 'openspec/changes/' directory. You can resume later using the '/opsx-continue' or '/opsx-apply' commands.

OpenSpec Workflow Onboarding

Name: OpenSpec Workflow Onboarding
Author: ValorVie

byValorVie

•

학습 및 문서화

Guides you through a complete OpenSpec development cycle using real tasks in your codebase to master the workflow.

This skill provides an interactive, hands-on tutorial for the OpenSpec methodology within Claude Code. It automates the process of finding a suitable starter task, creating a "change" container, and generating critical development artifacts like proposals, specifications, and design documents. By walking through the entire lifecycle—from exploration to implementation and final archiving—it ensures developers understand how to maintain a structured, documented, and reproducible coding workflow using the OpenSpec CLI. It is ideal for teams looking to standardize their development process and maintain high-quality project history.

주요 기능

01Guided Artifact Creation: Drafts technical proposals, specifications, and design documents interactively.

02Narrated Implementation: Executes code changes while explaining how specs and design decisions inform the work.

03Scope Guardrails: Provides feedback to ensure tasks are manageable and appropriately sized for the workflow.

04Automated Codebase Analysis: Scans for TODOs, missing tests, and type issues to suggest ideal starter tasks.

053 GitHub stars

06Historical Archiving: Teaches the process of preserving project decisions for long-term maintainability.

사용 사례

01Learning how to integrate structured documentation (proposals/specs) into an AI-driven coding workflow.

02Onboarding new developers to a project that utilizes the OpenSpec methodology.

03Converting simple technical debt or 'TODO' items into fully documented and implemented features.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add valorvie/custom-skills openspec-onboard

For use in Claude.ai and ChatGPT

Download Skill