openspec-onboard

Guide new contributors through the OpenSpec workflow from initialization to archival.

2|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/tonysyu/gqlxp --skill openspec-onboard-tonysyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/tonysyu/gqlxp/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/tonysyu/gqlxp --skill openspec-onboard-tonysyu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding is a guided, hands-on workflow that takes a new user through the complete setup and learning cycle, including real codebase work and narrated explanations.

Core Features & Use Cases

  • Guided, phase-based onboarding that covers preflight checks, task selection, explore mode, change creation, proposal, specs, design, tasks, apply, and archive.
  • Realistic, codebase-centered tasks with step-by-step instructions and narrative context suitable for team onboarding and training.
  • Reusable framework to onboard new contributors to OpenSpec, coaches, or product teams who want a structured learning path.

Quick Start

Start the onboarding flow to begin a guided OpenSpec learning cycle 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 contributors to OpenSpec workflows?

Onboard new contributors to OpenSpec workflows using a guided, phase-based cycle that covers preflight checks, task selection, change creation, proposals, specs, design, tasks, apply, and archive. It provides step-by-step instructions for real codebase work.

What is the OpenSpec change management process for codebase work?

The OpenSpec change management process enforces a structured pattern: preflight, phases, proposals, specs, design, tasks, apply, and archive. It ensures traceable change-records and guides users from initialization to artifact archival.

Can I use this guided onboarding flow for team-wide training?

Yes, you can use this guided onboarding flow for team-wide training. It applies to onboarding sessions, tutorials, and team training where users perform real codebase work and see live changes across phases with narrated explanations.

Do I need external prompts to run the OpenSpec tutorial?

No, you do not need external prompts to run the OpenSpec tutorial. The workflow requires no external prompts beyond follow-on commands, ensuring a self-contained learning cycle with traceable change-records.

What's the best way to teach OpenSpec specs and design phases?

The best way to teach OpenSpec specs and design phases is through a hands-on, codebase-centered tutorial. It provides narrative context and realistic tasks that walk new contributors through these specific workflow phases.

How does artifact archival work in OpenSpec?

Artifact archival in OpenSpec is the final phase of the structured workflow. After completing proposals, specs, design, tasks, and apply phases, the workflow guides users through archiving artifacts to ensure traceable change-records.