openspec-onboard

Guide new developers through the complete OpenSpec workflow with artifact creation.

4|2|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/finger-gun/sisu --skill openspec-onboard-finger-gun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/finger-gun/sisu/tree/main/.kilocode/skills/openspec-onboard
Command: npx skills add https://github.com/finger-gun/sisu --skill openspec-onboard-finger-gun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec onboarding can be time-consuming and error-prone; this skill provides a guided, hands-on journey that walks learners through a complete OpenSpec workflow in their own codebase with explanations and live artifacts.

Core Features & Use Cases

  • Step-by-step onboarding through the full OpenSpec lifecycle (preflight, task selection, explore, proposal, specs, design, tasks, apply, archive).
  • Hands-on practice in a real repository context, with narrated guidance and concrete tasks.
  • Safe, teach-first approach that records decisions and artifacts for future reference.

Quick Start

Start by initiating an onboarding session with /opsx:explore, then create a new change with /opsx:new.

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 when do I need it for change management?

The OpenSpec workflow is a structured change management process for creating artifacts like proposal.md, design.md, specs, and tasks. You need it to ensure safe, well-documented changes in a codebase with clear decision records and step-by-step execution.

How do I onboard a new developer through the OpenSpec lifecycle step by step?

You can onboard a developer by running a guided session starting with /opsx:explore to understand the codebase, then /opsx:new to create a change. This walks them through preflight, task selection, proposal, specs, design, tasks, and archiving.

Do I need any specific tools or dependencies installed to start OpenSpec onboarding?

No specific dependencies or components are required to start OpenSpec onboarding. You only need a real codebase repository context to practice in, as the skill provides a self-contained, teach-first guided execution environment.

What's the best way to practice creating OpenSpec artifacts like proposal and design docs in a real repository?

The best way to practice is through hands-on execution in your own repository. A guided onboarding session provides narrated guidance and concrete tasks to create proposal.md, design.md, specs, and tasks, recording decisions for future reference.

Can I use guided execution to train AI models or developers on safe codebase changes?

Yes, guided execution is designed for developer training and AI education. It applies a safe, teach-first approach to onboarding tasks in real codebases, walking learners through preflight checks and artifact creation with clear documentation.