openspec-onboard

Guide users through an end-to-end OpenSpec workflow cycle for a codebase change.

5|Updated Apr 29, 2026

Search Tags:#spec writing #developer productivity #change management #openspec #software implementation #codebase refactoring #workflow onboarding

Ready to run

npx skills add https://github.com/breuerfelix/spurwechsel --skill openspec-onboard-breuerfelix

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/breuerfelix/spurwechsel/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/breuerfelix/spurwechsel --skill openspec-onboard-breuerfelix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you ramp up on the OpenSpec workflow by guiding you through a complete, real end-to-end change cycle in your codebase, rather than teaching the concepts in the abstract.

Core Features & Use Cases

Guided onboarding for first runs: Narrated walkthrough that takes you from task selection to proposing, specifying, designing, implementing, and archiving a change. Real codebase interaction: Encourages scanning the repository for actionable targets (TODO/FIXME, missing validation, risky error handling, missing tests, debug artifacts) and then using the selected task for the workflow. Workflow guardrails with recovery: Softly prevents overly large first tasks, supports graceful exits mid-way, and provides commands to resume or jump to implementation.

Quick Start

Ask an AI agent to run openspec-onboard and walk you through your first OpenSpec workflow cycle using your current codebase, starting with task selection.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema

How do I learn the OpenSpec workflow for a real codebase change?▼

You learn the OpenSpec workflow by completing a full end-to-end change cycle in your codebase. This Skill guides you through selecting a small task, exploring relevant code, creating artifacts, implementing, and archiving the change.

Can I resume an OpenSpec onboarding workflow if I exit midway?▼

Yes, you can resume an OpenSpec onboarding workflow after a graceful exit. The Skill provides specific commands to resume the guided cycle or jump directly to the implementation phase if you stopped midway.

What kind of tasks are suitable for a first OpenSpec workflow cycle?▼

Suitable tasks for a first OpenSpec workflow cycle are small, actionable targets found in your codebase, such as TODOs, FIXMEs, missing validation, risky error handling, missing tests, or debug artifacts. The Skill enforces guardrails to prevent overly large first tasks.

Do I need the OpenSpec CLI to run the onboarding workflow?▼

Yes, you need the OpenSpec CLI installed to run the onboarding workflow. The Skill requires the CLI for executing commands as you progress through the EXPLAIN, DO, SHOW, and PAUSE teaching phases.

How does guided spec writing handle codebase refactoring onboarding?▼

Guided spec writing handles codebase refactoring onboarding by scanning your repository for actionable targets and walking you through creating OpenSpec artifacts. It follows an EXPLAIN, DO, SHOW, PAUSE teaching pattern to ensure you understand the workflow.