openspec-onboard

Guide new users through the OpenSpec change workflow from proposal to archive.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/whatevertogo/Astrcode --skill openspec-onboard-whatevertogo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/whatevertogo/Astrcode/tree/main/.codex/skills/openspec-onboard
Command: npx skills add https://github.com/whatevertogo/Astrcode --skill openspec-onboard-whatevertogo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding often stalls without a guided, hands-on path. This Skill provides a structured, beginner-friendly walkthrough that teaches how to create a change container, craft a proposal, define specs and design, and archive decisions within the OpenSpec workflow.

Core Features & Use Cases

  • Step-by-step onboarding of an OpenSpec project from exploration to archiving.
  • Interactive prompts that guide users to create and organize artifacts (proposal, specs, design, tasks).
  • Real-world, codebase-oriented tasks that demonstrate end-to-end workflow in a teaching environment.

Quick Start

Initiate the onboarding by starting a new change with /opsx:new and following the guided prompts to build your first OpenSpec change.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I start the OpenSpec onboarding workflow for a new project?

Start OpenSpec onboarding by initiating a new change with /opsx:new and following the interactive prompts. This guides you to iteratively create a change container, proposal, specs, design, and tasks for your project.

What is the OpenSpec change management cycle and how does it structure project artifacts?

The OpenSpec change management cycle is a structured workflow enforcing phases from exploration to archiving. It organizes artifacts by storing proposals, specs, design, and tasks under openspec/changes with archive support.

Do I need prior OpenSpec experience to use this guided workflow?

No prior OpenSpec experience is required. This workflow is designed for beginners, providing interactive prompts and real-world, codebase-oriented tasks to teach the end-to-end process in a learning environment.

Can I archive decisions and project changes using the OpenSpec workflow?

Yes, you can archive decisions using the OpenSpec workflow. The guided process supports archiving records under openspec/changes after you complete the proposal, specs, design, and tasks phases.

How do I create a proposal and define specs within an OpenSpec change container?

You create proposals and define specs by responding to interactive prompts during the workflow. The onboarding process guides you step-by-step to craft these artifacts within your initialized change container.

What are the limitations of using a guided onboarding workflow for OpenSpec?

The guided onboarding workflow targets initial learning sessions and beginner education. It enforces a strict structured OpenSpec cycle with user acknowledgment prompts, which may restrict advanced, freeform change management.