skills.rest
beliciobcardoso
beliciobcardosoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-onboard

Guides users through a complete OpenSpec change workflow with narrated phases and real codebase tasks.

Updated Mar 17, 2026
Search Tags:#onboarding#cli#change management#spec-driven development#openspec#guided learning#workflow tutorial
One-click install
npx skills add https://github.com/beliciobcardoso/mcp-postgres --skill openspec-onboard-beliciobcardoso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/beliciobcardoso/mcp-postgres/tree/main/.qwen/skills/openspec-onboard
Command: npx skills add https://github.com/beliciobcardoso/mcp-postgres --skill openspec-onboard-beliciobcardoso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development workflow is hard when documentation is abstract. This Skill teaches the OpenSpec workflow by doing—walking you through a real change cycle in your own codebase, from task selection to archiving, with explanations at every step. ## Core Features & Use Cases - Guided End-to-End Workflow: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with narration. - Codebase Task Discovery: Scans for TODOs, missing error handling, untested functions, and debug artifacts to suggest a suitable starter task. - Teaching-Oriented Guardrails: Uses an EXPLAIN → DO → SHOW → PAUSE pattern, scope guardrails for oversized tasks, and graceful mid-way exits. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix in their repo, and completes a full change cycle—ending with an archived decision record and working code. ## Quick Start Ask the assistant to start the OpenSpec onboarding tutorial and walk you through your first change on a real task in this codebase.

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?▼

Run the onboarding skill, which walks you through a full change cycle on a real task in your codebase. It covers explore mode, creating a change, writing proposal, specs, design, and tasks, then implementing and archiving.

What is an OpenSpec change and how do I create one?▼

An OpenSpec change is a container in openspec/changes/<name>/ holding proposal, specs, design, and tasks artifacts. Create one with the openspec new change command, then fill in each artifact step by step.

Does OpenSpec onboarding require the CLI installed?▼

Yes, the skill checks for the openspec CLI in a preflight step and stops if it is not installed. Install the CLI first, then rerun the onboarding command.

What happens if I stop the OpenSpec tutorial midway?▼

Your change is saved under openspec/changes/<name>/ and nothing is lost. You can resume later with /opsx:continue to finish artifacts or /opsx:apply to jump to implementation.

Can I use a large feature for my first OpenSpec change?▼

You can, but the skill recommends a small task for learning so you see the full cycle quickly. It offers to slice the work smaller, pick another task, or proceed anyway if you insist.

Related Skills

Explore More Software Engineering Skills→
wtg42wtg42

openspec-onboard

Guide OpenSpec CLI users through a complete change workflow with proposal, specs, design, tasks, and archive artifacts.

Community
Intermediate
styrene-labstyrene-lab
47

openspec

Coordinate OpenSpec lifecycle artifacts across change directories, specs, and tasks.

Official
Advanced
rock-hurock-hu

openspec-explore

Guide problem framing and requirement clarification through structured thinking prompts.

Community
Basic
istota-projectistota-project
10

todos

Manage plain-text TODO lists on Nextcloud-mounted storage.

Official
Basic