skills.rest
wishx127
wishx127COMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/wishx127/mirror-server --skill openspec-onboard-wishx127
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
opendatahub-ioopendatahub-io
36

shallow-clone

Creates a depth-1 clone of a Git repository in a temporary location.

Official
Intermediate
twilwatwilwa

openspec-archive-change

Archive completed OpenSpec changes with metadata and artifacts.

Community
Advanced
limzivectorlimzivector

health

Execute type checkers, linters, test runners, and dead code detectors to report codebase health.

Community
Advanced
tungnguyen10tungnguyen10

openspec-onboard

Guide new users through the OpenSpec spec-driven development workflow using real codebase tasks.

Community
Advanced