openspec-onboard

Guide OpenSpec change creation, planning, implementation, and archival in a codebase.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/brandon-setegn/kafka-test --skill openspec-onboard-brandon-setegn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/brandon-setegn/kafka-test/tree/main/.cursor/skills/openspec-onboard
Command: npx skills add https://github.com/brandon-setegn/kafka-test --skill openspec-onboard-brandon-setegn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you learn and execute the OpenSpec workflow end to end by guiding you through a real change in your codebase, from initial exploration to archived completion.

Core Features & Use Cases

  • Workflow Coaching: Walks you through explore, new, proposal, specs, design, tasks, apply, and archive.
  • Real Codebase Guidance: Scans your repository for small, practical tasks such as TODOs, missing tests, weak error handling, and debug artifacts.
  • Hands-On Learning: Shows how to create a change container, draft artifacts, implement the work, and preserve the decision history.
  • Use Case: A developer wants to understand OpenSpec while fixing a small issue in their project, so the Skill selects a starter task and leads them through the full cycle.

Quick Start

Ask me to guide you through a complete OpenSpec change cycle for a small task in your codebase.

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 by making a real codebase change?

To learn the OpenSpec workflow, you execute a real change cycle in your codebase from initial exploration to archived completion. This process guides you through structured proposals, specs, design, tasks, implementation, and archival for hands-on learning.

How do I use OpenSpec to plan and implement a small feature or bug fix?

You use OpenSpec to plan and implement a bug fix by creating a change container, drafting required artifacts, applying code changes, and archiving the final decision history. It structures the entire implementation process end to end.

What is the OpenSpec workflow process for creating and archiving codebase specs?

The OpenSpec workflow process involves exploring the codebase, creating a new change container, drafting proposals and specs, defining design and tasks, applying the implementation, and archiving the change to preserve decision history.

Can OpenSpec find small practical tasks like missing tests or TODOs in my repository?

Yes, OpenSpec can scan your repository to find small practical tasks like missing tests, TODOs, weak error handling, and debug artifacts. It selects these starter tasks to lead you through a complete change cycle.

Do I need the OpenSpec CLI to guide proposal and spec generation for onboarding?

Yes, you need the OpenSpec CLI to guide proposal and spec generation for onboarding. The workflow requires CLI commands to support exploratory task selection, artifact generation, and the final change archival in your repository.