skills.rest
ValorVie
ValorVieCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

Guides users through a complete OpenSpec change workflow cycle with narrated phases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New OpenSpec users often struggle to learn the spec-driven change workflow—creating changes, writing proposals, specs, designs, and tasks—without a structured walkthrough on real codebase work. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with explanations at each phase. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest starter tasks. - Scope Guardrails & Graceful Exits: Steers users toward small first tasks and lets them pause or exit without losing progress. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix from the suggestions, and completes a full change cycle—from proposal to archive—in about 20 minutes. ## Quick Start Ask the assistant to start the OpenSpec onboarding walkthrough and guide 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 for the first time?▼

Run the onboarding walkthrough, which guides you through a full 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 does OpenSpec onboarding pick a task to work on?▼

It scans your codebase for TODO and FIXME comments, missing error handling, untested functions, TypeScript any types, and debug artifacts, then presents three to four small suggested tasks. You can also describe your own task.

Does the OpenSpec onboarding skill require the CLI installed?▼

Yes, the openspec CLI must be installed before starting. The skill runs a preflight check with openspec --version and stops with an install prompt if the CLI is not found.

What happens if I stop the OpenSpec onboarding 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 OpenSpec onboarding for a large feature?▼

You can, but the skill applies a soft scope guardrail suggesting you slice large tasks smaller for the first run-through. It respects your choice if you insist on the larger task.

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
wonder-zhangwonder-zhang
1

iterate

Generate versioned delta changes from archived feature specs.

Community
Advanced
cynkracynkra
1

openspec-explore

Investigate codebase architecture and draft OpenSpec artifacts without implementing code.

Official
Basic
lucasmccomblucasmccomb

todo-create

Create structured todo Markdown files with YAML frontmatter in .claude/todos.

Community
Intermediate