openspec-onboard

Guide OpenSpec onboarding by creating and managing change artifacts.

1|Updated Feb 22, 2026

Search Tags:#workflow #onboarding #implementation #openspec #proposal #specs #change-management

Ready to run

npx skills add https://github.com/SiddharthChillale/cloud-operations-reasoning-agent --skill openspec-onboard-siddharthchillale

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/SiddharthChillale/cloud-operations-reasoning-agent/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/SiddharthChillale/cloud-operations-reasoning-agent --skill openspec-onboard-siddharthchillale

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers through a complete, hands-on OpenSpec workflow so they can learn by doing rather than reading documentation, reducing friction when introducing OpenSpec into a real repository and ensuring changes are created, specified, implemented, and archived correctly.

Core Features & Use Cases

Step-by-step onboarding: Walks through preflight checks, task selection, exploration, creating a change, drafting proposal/specs/design, breaking tasks, implementing work, and archiving the change.
Real repository interaction: Uses the repository files and openspec CLI commands to create openspec/changes artifacts, save proposals, specs, designs, and tasks, and optionally apply changes.
Teaching cadence & guardrails: Pauses for user acknowledgement, suggests scope reductions for large tasks, and provides graceful exit and command reference for quick lookup.

Quick Start

Ask the assistant to run a guided OpenSpec onboarding for this repository that creates a change, drafts proposal, writes specs and design, breaks tasks, implements the work, and archives 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 create and manage change artifacts for an OpenSpec workflow?▼

To create and manage change artifacts, you need to use the openspec CLI within an initialized repository to generate openspec/changes files, draft proposals, write specs, and implement small code changes.

How do I onboard to OpenSpec workflows in an existing codebase?▼

Onboarding to OpenSpec workflows involves a guided, step-by-step process that walks you through preflight checks, creating a change, drafting proposals and specs, implementing work, and archiving the change in your repository.

Do I need the openspec CLI installed to draft proposals and write specs?▼

Yes, you need the openspec CLI available in your environment and access to repository files to create and modify openspec/changes artifacts and run openspec commands for drafting proposals and writing specs.

What is the best way to handle large tasks during OpenSpec change implementation?▼

The best way to handle large tasks during OpenSpec change implementation is to follow workflow guardrails that suggest scope reductions and break tasks into smaller, manageable pieces before applying code changes.

Can I learn OpenSpec workflow by doing instead of reading documentation?▼

Yes, you can learn OpenSpec by doing through a hands-on guided workflow that interacts directly with your repository files to create changes, write specs, implement work, and archive changes, reducing friction and learning curve.