openspec-onboard

Guide users through the OpenSpec workflow cycle with their own codebase.

Updated Apr 15, 2026

Search Tags:#workflow #onboarding #codebase #guidance #openspec #task-suggestion

Ready to run

npx skills add https://github.com/caelaxie/agenthub --skill openspec-onboard-caelaxie

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/caelaxie/agenthub/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/caelaxie/agenthub --skill openspec-onboard-caelaxie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many developers struggle to learn the OpenSpec workflow because it combines several steps—exploration, proposal, specs, design, tasks, implementation, and archiving—without clear guidance. This Skill provides a structured, hands‑on tutorial that walks users through each phase using their own codebase.

Core Features & Use Cases

Step‑by‑step guidance through the full OpenSpec change lifecycle, from discovery to archiving.
Live codebase analysis to suggest real, small tasks you can work on.
Interactive phases that pause for user input, ensuring comprehension before moving on.
Suitable for onboarding new team members or anyone new to OpenSpec who wants practical, in‑context learning.

Quick Start

Ask the OpenSpec onboarding skill to guide you through a complete change cycle in your repository.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema

What is the OpenSpec workflow and what problem does it solve for developers?▼

The OpenSpec workflow is a structured change lifecycle process solving the lack of clear guidance during codebase modifications. It guides developers through exploration, proposal, specs, design, tasks, implementation, and archiving phases to ensure comprehensive change management.

How do I learn the OpenSpec workflow using my own codebase?▼

You can learn the OpenSpec workflow interactively by using an onboarding skill that analyzes your codebase and suggests real tasks. It provides step-by-step guidance through each lifecycle phase, pausing for user input to ensure comprehension before moving forward.

Can I use the OpenSpec workflow for onboarding new team members?▼

Yes, the OpenSpec workflow is suitable for onboarding new team members. It provides hands-on, in-context learning by walking them through a complete change cycle using the actual repository, ensuring practical experience with the full lifecycle.

Do I need external tools to run the OpenSpec workflow lifecycle?▼

No, you do not need external tools beyond the OpenSpec CLI to run the workflow lifecycle. The process provides stepwise artifact creation, interactive prompts, and code analysis for task suggestions entirely within the OpenSpec environment.

How does code analysis work during the OpenSpec task suggestion phase?▼

Code analysis during the OpenSpec task suggestion phase works by examining your live codebase to identify real, small tasks. It suggests actionable work items that fit into the implementation phase of the structured change lifecycle.

What are the limitations of the interactive OpenSpec onboarding process?▼

The interactive OpenSpec onboarding process requires active user participation, pausing for input at each phase, which limits full automation. It focuses on stepwise artifact creation and learning rather than autonomous end-to-end codebase modification.