openspec-onboard

Guide users through OpenSpec workflow phases using the openspec CLI.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/soyrochus/vulgata --skill openspec-onboard-soyrochus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/soyrochus/vulgata/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/soyrochus/vulgata --skill openspec-onboard-soyrochus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides new contributors and teams through a complete OpenSpec workflow so they can learn the process by doing real work in their repository, avoiding abstract or theoretical instruction that doesn't translate to practical results.

Core Features & Use Cases

  • End-to-end guided workflow: Stepwise narration and checkpoints for explore, propose, spec, design, tasks, apply, and archive phases.
  • Real repository integration: Scans code, suggests small starter tasks, creates change containers, drafts proposal/spec/design/tasks, and helps implement and archive the change using the openspec CLI.
  • Use Cases: Onboarding new engineers to project practices, running a lightweight design-to-implementation demo, or teaching product and engineering teams how to capture decision history and specs.

Quick Start

Run the OpenSpec onboarding flow in your repository with the openspec CLI to create and implement a small change while following the guided prompts.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I onboard new developers to an OpenSpec workflow?

Onboard developers to OpenSpec by running a guided, stepwise workflow cycle in your repository. This hands-on process walks users through explore, propose, spec, design, implement, and archive phases to learn by doing real work.

What is the best way to learn specification and change management for a new codebase?

The best way to learn specification and change management is through interactive onboarding that scans your code, suggests small starter tasks, and creates change containers to draft proposals, specs, and designs for real implementation.

Can I use the openspec CLI to guide teams through a design-to-implementation demo?

Yes, you can use the openspec CLI to run a lightweight design-to-implementation demo. It provides interactive guidance for creating change containers, drafting artifacts, generating tasks, and archiving changes.

How does a guided workflow cycle handle proposal drafting and task generation?

A guided workflow cycle handles proposal drafting and task generation by walking developers through structured phases. It creates a change container, drafts the proposal, spec, and design artifacts, and generates implementation tasks using repository files.

Do I need the openspec CLI installed to run an interactive onboarding flow?

Yes, the openspec CLI is required to run the interactive onboarding flow. The guided workflow performs CLI dependency checks and executes commands to create, implement, and archive changes directly in your repository.

When should I use an end-to-end specification workflow instead of ad-hoc code changes?

Use an end-to-end specification workflow when onboarding new engineers, teaching teams to capture decision history, or needing structured change management. Avoid it for trivial edits that do not benefit from formal proposal and design artifacts.