openspec-onboard

Guide users through the OpenSpec workflow cycle with codebase task analysis.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/dorrio/sorteo-app-generator --skill openspec-onboard-dorrio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/dorrio/sorteo-app-generator/tree/main/.agent/skills/openspec-onboard
Command: npx skills add https://github.com/dorrio/sorteo-app-generator --skill openspec-onboard-dorrio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides new users through the entire OpenSpec workflow, from task selection to archiving, ensuring they understand and can apply the process to their own projects.

Core Features & Use Cases

  • Guided Workflow: Step-by-step walkthrough of OpenSpec's change management process.
  • Codebase Integration: Analyzes the user's codebase to suggest relevant tasks.
  • Artifact Generation: Assists in creating proposals, specs, designs, and tasks.
  • Use Case: A new developer joins a team using OpenSpec. This Skill onboard them by having them complete a small, real task in the codebase, teaching them the tool's philosophy and mechanics interactively.

Quick Start

Initiate a guided onboarding session for OpenSpec.

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 codebase management?

To learn the OpenSpec workflow, you can use a guided tutorial that walks you through a complete change management cycle. It analyzes your codebase to suggest actionable tasks and provides real-time interaction to teach the process interactively.

What is the OpenSpec change management process for new developers?

The OpenSpec change management process is a structured workflow spanning task selection, artifact creation, proposal and spec design, implementation, and archiving. It ensures developers understand and apply consistent codebase changes through guided practice.

Do I need the OpenSpec CLI installed to start an onboarding session?

Yes, you need the OpenSpec CLI installed and initialized in your project before starting an onboarding session. The guided workflow relies on the CLI to interact with your codebase and manage artifacts.

How do I generate OpenSpec proposals and specs from my codebase?

You generate OpenSpec proposals and specs by initiating a guided workflow that analyzes your codebase for actionable tasks. The tutorial assists you in creating the required artifacts step by step to ensure proper change management.

Can I use a guided tutorial to practice OpenSpec artifact creation?

Yes, you can use a guided tutorial to practice OpenSpec artifact creation. It helps you complete a small, real task in your codebase, teaching you how to generate proposals, specs, designs, and tasks interactively.

What are the limitations of using an interactive guide for codebase onboarding?

The interactive guide is limited to projects where the OpenSpec CLI is already installed and initialized. It is specifically designed for onboarding new users through small tasks rather than managing large-scale complex implementations.