openspec-onboard

Guide users through a complete OpenSpec workflow cycle in their codebase.

Updated Apr 11, 2025
One-click install
npx skills add https://github.com/pabloimrik17/monolab --skill openspec-onboard-pabloimrik17
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/pabloimrik17/monolab/tree/main/.junie/skills/openspec-onboard
Command: npx skills add https://github.com/pabloimrik17/monolab --skill openspec-onboard-pabloimrik17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers through a full OpenSpec change workflow so they can learn by doing real work in their codebase, from selecting a small task to archiving the completed change.

Core Features & Use Cases

  • Guided, narrated onboarding: Walks the user step-by-step through explore, propose, specs, design, tasks, apply, and archive phases while explaining decisions.
  • Real-code execution: Uses the OpenSpec CLI to create openspec/changes artifacts (proposal, specs, design, tasks) and supports implementing and archiving a small scoped change.
  • Use Case: Ideal for new contributors or teams adopting OpenSpec who need a short, complete hands-on run-through that produces both code and decision records.

Quick Start

Invoke the onboarding, follow prompts to pick a small task, generate proposal/specs/design/tasks, implement the tasks, and archive the change.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I start using the OpenSpec CLI to create changes in my codebase?

To start an OpenSpec workflow, invoke the onboarding guide to select a small task, then use the OpenSpec CLI to generate proposal, specs, design, and tasks artifacts before implementing and archiving the change.

What is the OpenSpec change management workflow for new contributors?

The OpenSpec change management workflow is a guided cycle through explore, propose, specs, design, tasks, apply, and archive phases, allowing developers to learn the process by executing real changes and producing decision records.

Do I need a local git repository to draft OpenSpec proposals and specs?

Yes, you need access to the project's git repository to create, modify, and archive openspec/changes artifacts using the local OpenSpec CLI installation during the onboarding workflow.

Can I implement small scoped tasks directly through the OpenSpec workflow?

Yes, the OpenSpec workflow supports implementing small scoped tasks by generating the required proposal and specs first, then applying the tasks and archiving the completed change in your codebase.

What is the best way to onboard a team to OpenSpec change management?

The best way to onboard a team is to use a hands-on guided run-through that walks developers step-by-step through a complete OpenSpec cycle, from picking a task to archiving the change.

When should I not use the OpenSpec workflow for my project?

You should not use the OpenSpec workflow if you lack a local OpenSpec CLI installation or git repository access, as these are required to create, modify, and archive openspec/changes artifacts.