openspec-onboard

Guide users through OpenSpec change creation, proposal drafting, and archiving.

47|2|Updated Oct 30, 2023
One-click install
npx skills add https://github.com/runtime-env/runtime-env --skill openspec-onboard-runtime-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/runtime-env/runtime-env/tree/main/.gemini/skills/openspec-onboard
Command: npx skills add https://github.com/runtime-env/runtime-env --skill openspec-onboard-runtime-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams through a complete OpenSpec workflow, turning a vague idea into a structured change with hands-on practice in a real codebase.

Core Features & Use Cases

  • Step-through guidance: Walks you through exploration, change creation, proposal, specs, design, tasks, and archiving.
  • Hands-on coding practice: Performs real tasks in your repository to illustrate the workflow end-to-end.
  • Educational scaffold: Provides stage-by-stage prompts and checklists to teach OpenSpec rituals.

Quick Start

Run /opsx:ff to fast-forward through the onboarding scaffold, or /opsx:new to start a new onboarding change.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
What is the OpenSpec workflow for managing codebase changes?

The OpenSpec workflow guides developers through creating a change, drafting a proposal, defining specs and design, tracking tasks, and archiving the result to ensure a structured codebase modification process.

How do I onboard a development team to the OpenSpec workflow?

You can onboard a team by running the `/opsx:ff` command to fast-forward through the scaffold or `/opsx:new` to start a new onboarding change, providing step-by-step guidance through exploration and implementation.

What artifacts are required when drafting an OpenSpec proposal?

Drafting an OpenSpec proposal requires specific artifacts including proposal.md, specs, design documents, and task lists to enforce a complete learning loop and maintain structural consistency across changes.

Does the OpenSpec onboard skill work within an existing repository?

Yes, the OpenSpec onboard skill performs real tasks directly within your existing repository, providing hands-on coding practice to illustrate the end-to-end workflow for developers and teams.

When should I use the OpenSpec CLI for onboarding?

You should use the OpenSpec CLI when you need to guide a team through a complete workflow learning journey, turning a vague idea into a structured change with educational scaffolds and stage-by-stage checklists.

How does the OpenSpec workflow handle archiving a completed change?

The OpenSpec workflow archives the result after completing the implementation and task stages, ensuring the entire learning loop from change creation to final documentation is properly closed and stored.