openspec-onboard

Guide new users through OpenSpec onboarding with preflight checks and artifact creation.

Updated Jan 29, 2026

Search Tags:#workflow #onboarding #codebase #artifacts #archive #openspec #guardrails

Ready to run

npx skills add https://github.com/hongquandev/OpenSpec-VI --skill openspec-onboard-hongquandev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/hongquandev/OpenSpec-VI/tree/main/.agent/skills/openspec-onboard
Command: npx skills add https://github.com/hongquandev/OpenSpec-VI --skill openspec-onboard-hongquandev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding OpenSpec users can be confusing and time-consuming; this guide provides a structured, end-to-end path with guided steps to learn the codebase and workflows.

Core Features & Use Cases

Guided onboarding flow that covers preflight checks, task exploration, and artifact creation (proposal, specs, design, tasks) within a real project.
Hands-on practice with the codebase to understand the OpenSpec lifecycle and collaboration patterns.
Guardrails to keep the onboarding focused, with clear steps to create and archive a change as part of learning.

Quick Start

Launch the OpenSpec onboarding flow and follow the guided steps in the UI.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema

How do I start OpenSpec onboarding in a real codebase?▼

OpenSpec onboarding starts with preflight checks to validate your environment, then guides you through phase exploration and artifact creation within your project. You launch the flow and follow the UI's stage-delimited prompts to complete the lifecycle.

What artifacts do I need to create during the OpenSpec workflow?▼

The OpenSpec workflow requires creating structured artifacts including proposals, specs, design documents, and tasks. These artifacts map to the lifecycle phases and are ultimately archived to complete the onboarding process.

Can I use the OpenSpec onboarding workflow without prior experience?▼

Yes, the onboarding workflow is designed for new users learning the OpenSpec lifecycle. It includes built-in guardrails and stage-delimited prompts to keep the process focused, ensuring beginners can safely explore and create artifacts.

What is the best way to archive a change when learning OpenSpec?▼

The best way to archive a change in OpenSpec is by following the guided workflow's final stages. After creating your proposal, specs, design, and tasks, the workflow provides clear steps to properly archive the completed change as part of your learning.

Why does OpenSpec onboarding include preflight checks?▼

Preflight checks in OpenSpec onboarding ensure your codebase is properly configured before you begin. They validate the environment so you can focus on learning artifact creation and lifecycle phases without hitting preventable setup errors.

Does the OpenSpec workflow support hands-on practice with collaboration patterns?▼

Yes, the OpenSpec workflow emphasizes hands-on practice within a real project. This approach helps you understand both the lifecycle phases and the collaboration patterns required for structured artifact creation and archiving.