openspec-onboard

Guides step-by-step OpenSpec workflow cycles for creating, implementing, and archiving changes.

6|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/remiverdiesen/ark-fork --skill openspec-onboard-remiverdiesen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/remiverdiesen/ark-fork/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/remiverdiesen/ark-fork --skill openspec-onboard-remiverdiesen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It teaches users how to run a complete OpenSpec change cycle in a real codebase, reducing confusion about when to explore, propose, spec, design, implement, and archive work.

Core Features & Use Cases

  • Walks through selecting a small task from the repository and assessing scope.
  • Creates the change container and drafts proposal, specs, design, and tasks artifacts.
  • Implements the work with narration, checklists, and graceful pause/resume handling.
  • Use case: onboard a developer to OpenSpec by turning a real bug fix or small improvement into a fully tracked change.

Quick Start

Ask the assistant to guide you through an OpenSpec change cycle for a small task in your repository.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I manage a codebase change from proposal to archiving step by step?▼

Specification writing for a software change involves drafting detailed proposal, spec, and design artifacts before implementation, ensuring the scope and requirements are documented and tracked throughout the change management cycle.

How do I write specifications for a software change before implementation?▼

Specification writing for a software change involves drafting detailed proposal, spec, and design artifacts before implementation, ensuring the scope and requirements are documented and tracked throughout the change management cycle.

Can I pause an implementation workflow and resume it later without losing progress?▼

Yes, you can pause and resume an implementation workflow later without losing progress. The change management process includes graceful stop-and-resume handling, preserving task selection and implementation state across interruptions.

Does OpenSpec workflow onboarding work for small bug fixes in an existing repository?▼

OpenSpec onboarding guides you through selecting a small task from your repository, assessing its scope, and turning a bug fix or small improvement into a fully tracked change cycle.

What is the best way to learn change management workflows for a real codebase?▼

The best way to learn change management workflows is by running a complete cycle: selecting a real task, generating proposal and specification artifacts, implementing with checklists, and archiving the tracked change.

Why do I need task selection guardrails before implementing a codebase change?▼

Task selection guardrails ensure structured phase transitions and prevent scope creep by verifying that proposal and specification artifacts are fully drafted before implementation begins in the workflow.