openspec-onboard

Executes a phased OpenSpec onboarding workflow with checkpoints and artifact creation in a real codebase.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/AdJIa/markdown-x --skill openspec-onboard-adjia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/AdJIa/markdown-x/tree/main/.cursor/skills/openspec-onboard
Command: npx skills add https://github.com/AdJIa/markdown-x --skill openspec-onboard-adjia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding is a guided, hands-on process to teach developers how to work through a complete change cycle in a real codebase, from initialization to archival.

Core Features & Use Cases

  • Step-by-step onboarding flow: preflight checks, task exploration, change creation, drafting artifacts (proposal, specs, design, tasks), and implementation tracing.
  • Hands-on learning with real-world codebase interactions, with built-in pauses for reflection and learning.
  • Reusable pattern for teaching end-to-end workflows in software projects, team onboarding, and capability demonstrations.

Quick Start

Begin the OpenSpec onboarding guide and follow the phases from preflight to archive in your project workspace.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
What is a structured onboarding workflow for a real codebase?

A structured onboarding workflow guides developers through a complete change cycle from initialization to archival. It uses preflight checks, phased tasks, artifact creation, and implementation tracing to teach end-to-end software project changes.

How do I guide a new developer through a codebase onboarding process?

To guide a new developer through codebase onboarding, execute a structured workflow spanning preflight checks, task exploration, change creation, drafting artifacts like proposals and specs, and implementation tracing with built-in pauses for reflection.

How do I create change artifacts like proposals, specs, and tasks during onboarding?

To create change artifacts during onboarding, follow a phased workflow that includes drafting proposals, specs, design documents, and task lists. This ensures hands-on learning with reusable templates and proper change-archive discipline.

Can I use a hands-on onboarding tutorial for team software engineering projects?

Yes, you can use a hands-on onboarding tutorial for team software engineering projects. It provides a reusable pattern for teaching end-to-end workflows, team onboarding, and capability demonstrations with real-world codebase interactions and guardrails.

Do I need any dependencies or external components to run an OpenSpec onboarding workflow?

No dependencies or external components are required to run an OpenSpec onboarding workflow. The process operates independently using built-in preflight checks, artifact templates, and change-archive discipline within your project workspace.

What's the best way to maintain change-archive discipline during a coding onboarding process?

The best way to maintain change-archive discipline during a coding onboarding process is to execute a structured workflow that explicitly traces implementation steps and archives history from initialization through the final archival phase.