openspec-onboard

Guide users through the complete OpenSpec change cycle from exploration to archiving.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dvazquezd/openspec-governance --skill openspec-onboard-dvazquezd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/dvazquezd/openspec-governance/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/dvazquezd/openspec-governance --skill openspec-onboard-dvazquezd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill guides new users through the complete OpenSpec workflow, turning abstract concepts into hands-on experience with their own codebase.

Core Features & Use Cases

  • Guided Workflow Simulation: Walks users through creating a change, drafting artifacts (proposal, specs, design, tasks), implementing, and archiving.
  • Codebase Integration: Operates directly on the user's project, performing real code modifications and using project-specific context.
  • Use Case: A new developer joins a team using OpenSpec. They use this Skill to perform their first small bug fix, learning the entire process from start to finish in a safe, educational environment.

Quick Start

Use the openspec-onboard skill to learn the OpenSpec workflow by doing.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I learn the OpenSpec workflow for my codebase?

You can learn the OpenSpec workflow by using a guided tutorial that walks you through creating a change, drafting specs, implementing, and archiving directly on your project. This interactive approach turns abstract concepts into hands-on experience with your own codebase.

What is the OpenSpec development workflow process?

The OpenSpec workflow is a complete change cycle process that moves from initial exploration to archiving. It involves drafting artifacts like proposals, specs, designs, and tasks, then implementing those changes before finally archiving the completed work.

Do I need the OpenSpec CLI and a git repository to start onboarding?

Yes, full functionality requires the OpenSpec CLI and a git repository with a dev branch. The tutorial operates directly on your codebase to perform real code modifications using project-specific context, so these prerequisites are necessary.

Can I practice a bug fix safely while learning developer onboarding?

Yes, new developers can use this guided workflow to perform their first small bug fix. It provides a safe, educational environment that facilitates the entire process from start to finish while operating directly on the user's project.

What are the limitations of interactive codebase onboarding tutorials?

The main limitation is that the tutorial requires the OpenSpec CLI and a specific git environment with a dev branch to function. Without these prerequisites, it cannot perform real code modifications or provide project-specific context.