openspec-onboard

Guide engineering teams through an OpenSpec onboarding workflow using the OpenSpec CLI.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/MaplumeX/Blockwise --skill openspec-onboard-maplumex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/MaplumeX/Blockwise/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/MaplumeX/Blockwise --skill openspec-onboard-maplumex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding new OpenSpec users is often manual and scattered across tasks and docs. This Skill provides a guided, hands-on onboarding flow that runs inside a real codebase with narrated steps and actionable tasks.

Core Features & Use Cases

  • Step-by-step onboarding: guides users through the complete OpenSpec workflow from initial setup to archiving changes.
  • Real-code integration: uses a live codebase to demonstrate task selection, change creation, and artifact generation.
  • Safe, learn-by-doing: provides guardrails, checkpoints, and practical examples to reinforce understanding.

Quick Start

Kick off onboarding by running openspec new change and following the guided prompts.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I onboard my engineering team to OpenSpec in a real codebase?

OpenSpec onboarding is achieved through a guided, learn-by-doing workflow that runs directly inside your live codebase. It provides narrated steps and actionable tasks to safely teach teams the entire change management process.

What is the end-to-end OpenSpec change management workflow?

The OpenSpec workflow covers the complete lifecycle from initial preflight setup to archiving changes. It enforces safe, incremental changes using the OpenSpec CLI to guide teams through task selection, change creation, and artifact generation.

How do I start creating a new change with OpenSpec?

To start creating a new change with OpenSpec, run the command `openspec new change` in your terminal. This initiates the guided onboarding flow and presents interactive prompts to walk you through the setup.

Can I use OpenSpec onboarding for existing software engineering projects?

Yes, OpenSpec onboarding is designed for existing software engineering projects by integrating directly with a real codebase. It provides guardrails and checkpoints to ensure safe, incremental changes during the learning process.

What is the best way to learn OpenSpec for DevOps teams?

The best way for DevOps teams to learn OpenSpec is through hands-on practice in a live environment. This guided approach reinforces understanding through practical examples, safe guardrails, and incremental change execution.

Why does OpenSpec onboarding use a learn-by-doing approach?

OpenSpec onboarding uses a learn-by-doing approach to replace manual, scattered documentation with actionable tasks. This ensures teams practically understand change management by executing safe, incremental changes directly in the codebase.