openspec-onboard

Guide new developers through a complete OpenSpec change cycle in their codebase.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/SQDR2/PortableConversationScriptAssistant --skill openspec-onboard-sqdr2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/SQDR2/PortableConversationScriptAssistant/tree/main/.github/skills/openspec-onboard
Command: npx skills add https://github.com/SQDR2/PortableConversationScriptAssistant --skill openspec-onboard-sqdr2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This onboarding Skill helps new developers learn OpenSpec by guiding them through a complete change workflow inside their codebase, turning a learning experience into practical, hands-on work.

Core Features & Use Cases

  • Step-by-step guided onboarding through preflight, task selection, proposal, specs, design, tasks, and archive.
  • Hands-on codebase interaction: perform real work in a project while learning the OpenSpec workflow.
  • Structured documentation workflow: produces a repeatable narrative and artifacts that capture decisions for future reference.

Quick Start

Run the onboarding workflow in your project to practice the full OpenSpec cycle.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
What is OpenSpec onboarding and how does it teach the codebase workflow?

OpenSpec onboarding is a guided workflow that teaches developers by executing a complete change cycle inside a codebase. It moves users step-by-step through preflight, proposal, specs, design, tasks, and archive phases to produce structured documentation artifacts.

How do I document a codebase change cycle from proposal to archive?

To document a codebase change cycle, you follow a structured workflow that captures a proposal, specs, design, tasks, and an archival record. This step-by-step process ensures all decisions and implementation details are recorded for future reference during the change management process.

Can I learn OpenSpec by doing real work in my existing project?

Yes, you can learn OpenSpec by performing real work in your existing project. The onboarding workflow interacts directly with your codebase, allowing you to practice iterative task creation and implementation while generating actual structured documentation artifacts.

Do I need any specific tools or dependencies to start the OpenSpec workflow?

No specific external dependencies are required to start the OpenSpec workflow. You only need your existing codebase environment to run the onboarding process, which provides explicit guardrails and step-by-step prompts to guide your structured change management cycle.

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

The guided onboarding workflow is limited to teaching the OpenSpec process through a single complete change cycle. It focuses on structured documentation and hands-on learning within your codebase, meaning it may not cover highly complex, multi-branch parallel change management scenarios.