skills.rest
germainlefebvre4
germainlefebvre4COMMUNITY
Explore all skills by this author →
𝕏@germainlefebvr4GitHub

openspec-onboard

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

Updated Jul 31, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#proposal#change workflow
One-click install
npx skills add https://github.com/germainlefebvre4/cvwonder-forms --skill openspec-onboard-germainlefebvre4
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/germainlefebvre4/cvwonder-forms/tree/main/.gemini/skills/openspec-onboard
Command: npx skills add https://github.com/germainlefebvre4/cvwonder-forms --skill openspec-onboard-germainlefebvre4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development workflow is hard without hands-on practice. This Skill teaches the full OpenSpec change cycle by walking you through a real task in your own codebase, explaining each artifact as it is created. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with narration at each phase. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails: Detects oversized tasks and helps slice them into manageable pieces suitable for a first run-through. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix like removing console.log statements, and completes a full change cycle—from proposal to archived decision record—in about 20 minutes. ## Quick Start Ask the assistant to start the OpenSpec onboarding tutorial and walk you through your first complete change cycle 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 for the first time?▼

Run the OpenSpec onboarding flow, which walks you through a complete change cycle on a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archiving with explanations at each step.

How do I create a change in OpenSpec?▼

Create a change with the openspec new change command using a kebab-case name. This generates a change directory containing proposal.md, design.md, specs/, and tasks.md files that you fill in as the workflow progresses.

Does OpenSpec onboarding work without the CLI installed?▼

No, the OpenSpec CLI must be installed first. The onboarding runs a preflight check with openspec --version and stops with an installation prompt if the CLI is not found.

What happens if I stop the OpenSpec tutorial midway?▼

Your change is saved at the changeRoot reported by openspec status. You can resume later with /opsx:continue to finish artifacts or /opsx:apply to jump to implementation if tasks already exist.

How does OpenSpec handle tasks that are too large?▼

The onboarding applies a soft scope guardrail when you pick a large task. It suggests slicing the work into a smaller piece, picking a different task, or proceeding anyway if you insist.

Related Skills

Explore More Software Engineering Skills→
girlguidingstaplehurstgirlguidingstaplehurst

openspec-archive-change

Archives completed OpenSpec changes after verifying artifacts, tasks, and spec sync state.

Official
Advanced
etrigan16etrigan16

sdd-onboard

Guides users through a complete spec-driven development cycle on a real codebase.

Community
Advanced
cynkracynkra
1

openspec-explore

Investigate codebase architecture and draft OpenSpec artifacts without implementing code.

Official
Basic
jp5labsjp5labs
1

forge-discover

Classifies idea complexity and routes work to the appropriate specification or issue workflow.

Official
Intermediate