skills.rest
zh-impact
zh-impactCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

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

Updated Apr 7, 2026
Search Tags:#workflow#onboarding#cli#tutorial#change management#spec-driven development#openspec
One-click install
npx skills add https://github.com/zh-impact/agent-feeder --skill openspec-onboard-zh-impact
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/zh-impact/agent-feeder/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/zh-impact/agent-feeder --skill openspec-onboard-zh-impact

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New OpenSpec users often struggle to learn the change-driven workflow (proposal, specs, design, tasks, apply, archive) without a hands-on walkthrough tied to real work in their own codebase. ## Core Features & Use Cases - Guided Workflow Tutorial: Walks through the full OpenSpec cycle—explore, create change, proposal, specs, design, tasks, implementation, and archive—with explanations at each phase. - Codebase Task Discovery: Scans the repository for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest small starter tasks. - Scope Guardrails and Graceful Exits: Steers users toward appropriately sized first tasks and supports pausing, resuming, or skipping to a command reference. - Use Case: A developer new to OpenSpec runs the onboarding skill, picks a small real fix in their repo, and completes a full change cycle in about 15-20 minutes while learning each artifact's purpose. ## Quick Start Ask the assistant to start the OpenSpec onboarding walkthrough and guide 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 onboarding skill, which walks you through a full change cycle on a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archive 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, any types, and debug statements, then suggests three to four small starter tasks. You can also describe your own task.

Does the OpenSpec onboarding skill require the openspec CLI?▼

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

Can I pause the OpenSpec onboarding and resume later?▼

Yes, your change is saved under openspec/changes/<name>/ and nothing is lost. Resume later with /opsx:continue to continue artifacts or /opsx:apply to jump to implementation.

What happens if my first OpenSpec task is too large?▼

The skill applies a soft scope guardrail and suggests slicing the task smaller or picking another suggestion. You can override and proceed with the larger task 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
kurojskurojs
2

sdd-onboard

Guides users through an SDD onboarding cycle on their actual codebase to implement a small, safe improvement.

Community
Advanced
sebasmzgsebasmzg

sdd-explore

Explore proposed features and code areas before committing changes.

Community
Intermediate
istota-projectistota-project
10

todos

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

Official
Basic