openspec-onboard

Guide new users through a complete OpenSpec change cycle from proposal to archive.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/woutervanranst/Arius7 --skill openspec-onboard-woutervanranst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/woutervanranst/Arius7/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/woutervanranst/Arius7 --skill openspec-onboard-woutervanranst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding can be complex and error-prone for new users; this skill provides a guided, reproducible path that teaches the end-to-end OpenSpec change cycle, reducing setup friction and accelerating learning.

Core Features & Use Cases

  • Interactive, step-by-step onboarding that walks a user through preflight checks, task selection, change creation, drafting a proposal, defining specs, designing, implementing, and archiving the change.
  • Real-world workflow in a codebase to demonstrate how OpenSpec changes are organized and reviewed, with guardrails to prevent incomplete artifacts.
  • Use Case: A developer new to OpenSpec follows the guided flow to onboard a project, create a change container, and reach an archived change record that documents decisions.

Quick Start

Begin the OpenSpec onboarding flow in your project to experience a complete change cycle from proposal to archive.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I onboard a new developer to OpenSpec changes in my codebase?

You can onboard new users by running a guided workflow that walks them through a complete change cycle from proposal to archiving. This enforces a repeatable artifact structure for consistent adoption across codebases.

What is the OpenSpec change cycle workflow?

The OpenSpec change cycle is a structured workflow spanning installation, task selection, change creation, drafting proposals and specs, design, implementation, and archiving. It organizes changes in a codebase with guardrails to prevent incomplete artifacts.

How do I create and archive an OpenSpec change proposal?

You create and archive an OpenSpec change by following a guided flow that covers preflight checks, task selection, change creation, drafting specifications, implementing, and archiving the change to document decisions.

Do I need the OpenSpec CLI installed to start the onboarding workflow?

Yes, the guided onboarding workflow begins with preflight checks that include the installation and validation of the OpenSpec CLI before proceeding to task selection and change creation.

How to enforce consistent artifact structure for OpenSpec changes?

To enforce consistent artifact structure for OpenSpec changes, use a guided onboarding workflow that provides guardrails preventing incomplete artifacts and requires concrete structure for the changes folder.