openspec-onboard

Guide users through the OpenSpec workflow with repository analysis and artifact generation.

Updated Jul 6, 2025

Search Tags:#workflow #onboarding #implementation #spec writing #codebase analysis #openspec

Ready to run

npx skills add https://github.com/wishx127/mirror-server --skill openspec-onboard-wishx127

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/wishx127/mirror-server/tree/main/.codebuddy/skills/openspec-onboard
Command: npx skills add https://github.com/wishx127/mirror-server --skill openspec-onboard-wishx127

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps a user learn and execute the OpenSpec workflow in a real codebase instead of only reading documentation.

Core Features & Use Cases

Guided onboarding from first question to archived change.
Real repository analysis to suggest a small, practical task.
Step-by-step creation of proposal, specs, design, and tasks.
Hands-on implementation and archive flow with clear guardrails.
Use case: a developer wants to understand OpenSpec while improving a project and needs a complete example they can follow.

Quick Start

Ask the assistant to guide you through an OpenSpec onboarding run in this repository and help you complete one small change from exploration to archive.

Frequently Asked Questions about openspec-onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I learn OpenSpec by shipping a real change in an existing codebase?▼

To learn OpenSpec by shipping a real change, you need a guided onboarding workflow that analyzes your codebase, suggests a small task, and walks you through proposal drafting, spec writing, implementation, and archival.

What is the OpenSpec workflow for creating and archiving changes?▼

The OpenSpec workflow involves analyzing a repository to discover a task, then step-by-step creating proposals, specs, design notes, and tasks, followed by hands-on implementation and archiving the change with clear guardrails.

How do I write OpenSpec specs and proposals for a new codebase change?▼

Writing OpenSpec specs and proposals requires inspecting the real codebase to select a practical task, then drafting artifacts aligned to OpenSpec commands and change folders through a phase-by-phase narration process.

Can I use OpenSpec onboarding for large tasks in an existing repository?▼

OpenSpec onboarding applies to existing repositories but uses soft scope guardrails to suggest a small, practical task, ensuring you can complete the full change creation cycle from exploration to archive without being overwhelmed.

Do I need an existing repository to start an OpenSpec onboarding session?▼

Yes, an OpenSpec onboarding session requires an existing repository because the workflow relies on real codebase inspection and analysis to discover tasks, generate artifacts, and guide implementation phase-by-phase.

What's the best way to practice spec writing and codebase analysis with OpenSpec?▼

The best way to practice spec writing and codebase analysis with OpenSpec is a guided onboarding run that takes you through task discovery, proposal drafting, design notes, and implementation to archive a complete change.