skills.rest
UnterrainerInformatik
UnterrainerInformatikOFFICIAL
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 Apr 20, 2020
Search Tags:#onboarding#cli#change management#spec-driven development#openspec#guided walkthrough#workflow tutorial
One-click install
npx skills add https://github.com/UnterrainerInformatik/java-rdb-utils --skill openspec-onboard-unterrainerinformatik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/UnterrainerInformatik/java-rdb-utils/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/UnterrainerInformatik/java-rdb-utils --skill openspec-onboard-unterrainerinformatik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development workflow is hard without hands-on practice. This Skill walks you through your first complete OpenSpec change cycle—explore, propose, spec, design, task, implement, archive—using a real task in your own codebase, so you learn by doing rather than reading documentation. ## Core Features & Use Cases - Guided Workflow Onboarding: Walks through every OpenSpec phase (explore, proposal, specs, design, tasks, apply, archive) with explanations at each step. - Codebase Task Discovery: Scans your repository for TODOs, missing error handling, untested functions, and debug artifacts to suggest suitable starter tasks. - Scope Guardrails & Graceful Exits: Gently steers oversized tasks toward smaller slices and lets you pause or exit at any point without losing work. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix from the suggested list, and completes a full change cycle in about 15-20 minutes while learning each command. ## Quick Start Ask the assistant to start the OpenSpec onboarding tutorial and walk you through your first change using 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—explore, proposal, specs, design, tasks, implementation, and archive—using a real task from your codebase. It takes about 15-20 minutes and explains each step as you go.

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 leftover debug statements, then presents 3-4 small suggested tasks. You can also describe your own task instead.

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 tutorial halfway through?▼

Your change is saved in the openspec/changes directory 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 slicing it smaller for the first run so you see the full cycle quickly. It offers options to narrow the scope, pick another task, or proceed anyway if you insist.

Related Skills

Explore More Software Engineering Skills→
aehrcaehrc
133

openspec-new-change

Scaffold a new change directory in the OpenSpec system.

Official
Intermediate
etrigan16etrigan16

sdd-onboard

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

Community
Advanced
kuchida1981kuchida1981

openspec-explore

Explore ideas, requirements, and codebase context before implementation.

Community
Intermediate
afadhityaafadhitya
4

openspec-ff-change

Generate all OpenSpec artifacts and resolve dependencies via the openspec CLI.

Community
Intermediate