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.