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.