skills.rest
javakishore-veleti
javakishore-veletiCOMMUNITY
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 Aug 7, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#proposal#change workflow
One-click install
npx skills add https://github.com/javakishore-veleti/lifting-diary-app --skill openspec-onboard-javakishore-veleti
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/javakishore-veleti/lifting-diary-app/tree/main/.qwen/skills/openspec-onboard
Command: npx skills add https://github.com/javakishore-veleti/lifting-diary-app --skill openspec-onboard-javakishore-veleti

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learning a new spec-driven development workflow is hard when documentation is abstract. This Skill teaches the OpenSpec change lifecycle 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 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 first-run changes. - Use Case: A developer new to OpenSpec runs the onboarding flow, picks a small fix like removing console.log statements, and completes a full change cycle—proposal through archive—in about 20 minutes. ## Quick Start Ask the assistant to walk you through your first OpenSpec change using a small task from your 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?▼

Run the onboarding flow, which walks you through a complete change cycle using a real task in your codebase. It covers creating a change, drafting a proposal, writing specs and design, implementing tasks, and archiving, with explanations at each step.

How do I create my first OpenSpec change?▼

The onboarding flow creates a change with the openspec new change command, then fills in proposal, specs, design, and tasks artifacts step by step. Each artifact is drafted for your approval before being saved.

What happens if the OpenSpec CLI is not installed?▼

The skill runs a preflight check with openspec --version before starting. If the CLI is missing, it tells you to install it first and stops, since all workflow commands depend on it.

Can I stop the OpenSpec onboarding halfway through?▼

Yes, exiting mid-way is handled gracefully. Your change is saved at its changeRoot path, 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: it suggests slicing the task into a smaller piece or picking a different one. You can override and proceed with the larger task if you insist.

Related Skills

Explore More Software Engineering Skills→
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
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
tungnguyen10tungnguyen10

openspec-onboard

Guide new users through the OpenSpec spec-driven development workflow using real codebase tasks.

Community
Advanced