openspec-onboard

Guide users through an OpenSpec change cycle with CLI commands.

10|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/joannanowakowska/plannning-poker-app --skill openspec-onboard-joannanowakowska
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/joannanowakowska/plannning-poker-app/tree/main/.github/skills/openspec-onboard
Command: npx skills add https://github.com/joannanowakowska/plannning-poker-app --skill openspec-onboard-joannanowakowska

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users learn the OpenSpec workflow end to end by turning a real codebase task into a guided, structured change process. It reduces confusion around how to explore, plan, implement, and archive work with OpenSpec.

Core Features & Use Cases

  • Task discovery: Scans a codebase for small, practical starter improvements such as TODOs, missing validation, debug artifacts, and weak error handling.
  • Workflow coaching: Walks the user through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with clear narration.
  • Real change execution: Uses OpenSpec CLI commands to create and manage an actual change in the repository while keeping the user involved at each step.
  • Use case: A developer wants to understand OpenSpec by fixing a small issue in their project and learning how the planning artifacts connect to code changes.

Quick Start

Ask me to onboard you through an OpenSpec workflow cycle on your repository and I will help you pick a small task, create the change, and guide you through each artifact.

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 codebase onboarding?

OpenSpec workflow onboarding is learned by applying the complete change cycle to a small real task in your repository, guiding you through proposal, specs, design, tasks, implementation, and archiving. It turns practical codebase improvements into structured workflow training.

How do I find small tasks in my codebase for OpenSpec change management?

Codebase analysis for change management involves scanning your repository to identify practical starter improvements such as TODOs, missing validation, debug artifacts, and weak error handling. These small tasks serve as real work to execute and learn the OpenSpec workflow.

What is the OpenSpec change cycle process for incremental repository improvements?

The OpenSpec change cycle coordinates proposal creation, specs, design, tasks, implementation, and archiving steps. It ensures planning artifacts stay synchronized with real code changes during incremental repository improvements using OpenSpec CLI commands and validation.

Do I need OpenSpec CLI commands to use this change management workflow?

Yes, OpenSpec CLI commands are required to create and manage actual changes in the repository. The workflow coaching walks you through using these commands to create the change container and coordinate proposal, specs, design, tasks, implementation, and archive steps.

Can I use OpenSpec for codebase onboarding and workflow training simultaneously?

Yes, OpenSpec applies to codebase onboarding, workflow training, and incremental repository improvements simultaneously. By fixing a small issue in your project, you learn how planning artifacts connect to code changes while executing a real change in the repository.