openspec-onboard

Guide users through the OpenSpec workflow cycle from Explore to Archive.

Updated Nov 12, 2025
One-click install
npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-onboard-artagon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/artagon/artagon-vscode-profiles/tree/main/agents/skills/openspec-onboard
Command: npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-onboard-artagon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you learn the OpenSpec workflow by guiding you through an end-to-end change cycle in your actual codebase, instead of leaving you to figure out the artifacts, sequence, and decisions alone.

Core Features & Use Cases

  • Guided end-to-end workflow: Walks through Explore → New Change → Proposal → Specs → Design → Tasks → Apply → Archive.
  • Real codebase task selection: Prompts you to choose a small, concrete improvement based on signals like TODOs, missing error handling, weak validation, and debug artifacts.
  • Teaching with checkpoints: Uses preflight checks for the required CLI, includes pause points for approval at key transitions, and provides scope guardrails for learning.

Quick Start

Start the onboarding walkthrough at /opsx:onboard after confirming the OpenSpec CLI is installed.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I learn the OpenSpec workflow for codebase collaboration?

You learn the OpenSpec workflow by completing a guided end-to-end change cycle in your codebase, moving through Explore, Proposal, Specs, Design, Tasks, Apply, and Archive phases with built-in checkpoints and scope guardrails.

What is the OpenSpec specification cycle and how do its phases work?

The OpenSpec specification cycle is a structured change management process moving from Explore and Proposal to Specs, Design, Tasks, Apply, and Archive, ensuring codebase improvements are documented and implemented systematically.

How do I start an OpenSpec onboarding walkthrough for a real codebase task?

Start the OpenSpec onboarding walkthrough by ensuring the openspec CLI is installed, then select a small concrete codebase improvement like fixing a TODO or adding error handling to practice the full specification cycle.

Do I need the openspec CLI installed to use the onboarding workflow?

Yes, the openspec CLI is required because the onboarding workflow relies on it to create changes, save specification artifacts, and apply implementation tasks within your codebase during the guided cycle.

What kind of tasks should I select for an OpenSpec change management practice cycle?

Select small, concrete codebase improvements like addressing TODOs, adding missing error handling, or fixing weak validation, ensuring the task remains scoped for learning the specification workflow without overwhelming the change cycle.