openspec-onboard

Guide users through a complete OpenSpec change cycle with phase-based onboarding.

1|Updated May 7, 2024
One-click install
npx skills add https://github.com/sitdownkevin/blog-next --skill openspec-onboard-sitdownkevin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/sitdownkevin/blog-next/tree/main/.cursor/skills/openspec-onboard
Command: npx skills add https://github.com/sitdownkevin/blog-next --skill openspec-onboard-sitdownkevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding new contributors and engineers to OpenSpec can be time-consuming and error-prone. This Skill guides users through a complete OpenSpec workflow cycle with narration and hands-on practice in a real codebase, reducing ramp-up time and aligning teams on the standard process.

Core Features & Use Cases

  • Guided, end-to-end onboarding that leads you from initialization through archival of a change.
  • Phase-by-phase guidance (Preflight, Welcome, Task Selection, Explore, Create Change, Proposal, Specs, Design, Tasks, Apply, Archive) with concrete prompts and examples.
  • Artifactual workflow scaffolding that demonstrates how to create and manage proposal.md, design.md, specs/, and tasks.md within openspec/changes.

Quick Start

Begin by invoking the onboarding workflow to walk through creating and archiving a complete OpenSpec change in your project.

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 engineers to an OpenSpec workflow?▼

You can onboard new engineers to an OpenSpec workflow by running a guided, end-to-end cycle that provides phase-by-phase narration and hands-on practice for creating and archiving changes in a real codebase.

What are the phases of a complete OpenSpec change cycle?▼

A complete OpenSpec change cycle includes initialization, task creation, explore mode, proposal, specs, design, tasks, apply, and archival, with phase-based guidance and concrete prompts at each step.

How do I create and manage OpenSpec artifacts like proposals and specs?▼

You create and manage OpenSpec artifacts by scaffolding files such as proposal.md, design.md, specs/, and tasks.md within the openspec/changes directory during the workflow phases.

Can I pause and resume a guided OpenSpec onboarding workflow?▼

Yes, the guided OpenSpec onboarding workflow enforces pause and resume guardrails, allowing you to halt the end-to-end orchestration and continue the change management cycle later without losing progress.

Does OpenSpec onboarding work for new projects and existing teams?▼

Yes, OpenSpec onboarding applies to both new projects and existing teams learning the standard process, reducing ramp-up time and aligning contributors on change management workflows.

What is the best way to teach change management workflows to new contributors?▼

The best way to teach change management workflows is through a guided onboarding cycle that leads new contributors from initialization through archival with artifact generation and hands-on practice in a real codebase.