skills.rest
shrek-abaper
shrek-abaperCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

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

Updated Jul 23, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#guided walkthrough#change workflow
One-click install
npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill openspec-onboard-shrek-abaper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/shrek-abaper/sap-nexus-agent/tree/main/.comet/skills/skills/openspec-onboard
Command: npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill openspec-onboard-shrek-abaper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven workflow is hard when documentation is abstract; this Skill teaches the OpenSpec change lifecycle by doing real work in your own codebase, with narration at every step. ## Core Features & Use Cases - Guided Full-Cycle Walkthrough: Covers explore, change creation, proposal, specs, design, tasks, implementation, and archive phases with EXPLAIN → DO → SHOW → PAUSE teaching pattern. - Codebase Task Discovery: Scans for TODO/FIXME comments, missing error handling, untested functions, and debug artifacts to suggest appropriately scoped starter tasks. - Graceful Exits and Guardrails: Handles mid-session stops, scope-too-large steering, and command-reference-only requests without losing progress. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small real fix from the suggestions, and completes their first archived change in about 15-20 minutes while learning every command. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using the openspec-onboard skill on a small task in this repository.

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 guided onboarding, which walks you through a complete change cycle on a real task in your codebase. It covers explore, proposal, specs, design, tasks, implementation, and archive in about 15-20 minutes with narration at each step.

How does the 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 statements, then presents 3-4 small scoped suggestions. You can also describe your own task.

What happens if the OpenSpec CLI is not installed?▼

The skill runs a preflight check for the openspec CLI before starting. If it is not installed, it tells you to install the CLI first and stops without proceeding.

Can I stop the OpenSpec onboarding halfway through?▼

Yes, the skill handles mid-session exits gracefully. Your change is saved under openspec/changes/<name>/ and you can resume later with /opsx:continue or jump to implementation with /opsx:apply.

What if my chosen task is too large for a first OpenSpec run?▼

The skill applies a soft scope guardrail, suggesting you slice the task smaller or pick another suggestion. You can override and proceed with the larger task if you insist.

Related Skills

Explore More Software Engineering Skills→
SiddharthChillaleSiddharthChillale

openspec-onboard

Guide OpenSpec onboarding by creating and managing change artifacts.

Community
Intermediate
hivellmhivellm
15

Rulebook Task Management

Automate spec-driven task creation, validation, and archiving with Rulebook commands.

Official
Intermediate
anionDevelopmentanionDevelopment

openspec-explore

Explores ideas and clarifies requirements through OpenSpec change artifacts and codebase investigation.

Official
Advanced
TencentBlueKingTencentBlueKing
840

openspec-ff-change

Generates all OpenSpec change artifacts in one pass using the openspec CLI.

Official
Intermediate