skills.rest
trutoman
trutomanCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

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

1|Updated Jun 30, 2026
Search Tags:#onboarding#cli#tutorial#spec-driven development#openspec#proposal#change workflow
One-click install
npx skills add https://github.com/trutoman/Conjuros --skill openspec-onboard-trutoman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/trutoman/Conjuros/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/trutoman/Conjuros --skill openspec-onboard-trutoman

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 a full OpenSpec change cycle on a real task in your own codebase, explaining each phase as you go. ## Core Features & Use Cases - Guided Workflow Cycle: Walks through explore, change creation, proposal, specs, design, tasks, implementation, and archiving with narration at each step. - Codebase Task Discovery: Scans for TODO/FIXME 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 pieces suitable for a first run-through. - Use Case: A developer new to OpenSpec runs the onboarding, picks a small fix from the suggestions, and completes a full propose-to-archive cycle in about 15-20 minutes while learning the commands. ## Quick Start Ask the assistant to start the OpenSpec onboarding tutorial and walk 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 hands-on?▼

Run the openspec-onboard 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 archiving with explanations at each phase.

How do I create my first OpenSpec change?▼

The onboarding flow creates a change with openspec new change using a derived kebab-case name, then fills in proposal, specs, design, and tasks artifacts step by step. Each artifact is saved to the resolvedOutputPath returned by the openspec instructions command.

Does openspec-onboard work without the OpenSpec CLI installed?▼

No, the skill requires the OpenSpec CLI. It runs a preflight check with openspec --version and stops with an install prompt if the CLI is not found on your system.

What happens if I pick a task that is too large for onboarding?▼

The skill applies a soft scope guardrail and suggests slicing the task into a smaller piece, picking a different suggestion, or proceeding anyway. You can override the guardrail if you insist on the larger task.

Can I pause the OpenSpec onboarding and resume later?▼

Yes, your change is saved at the changeRoot reported by openspec status. You can resume later with /opsx-continue for artifact creation or /opsx-apply to jump to implementation if tasks already exist.

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
zhuangpengLIzhuangpengLI
15

openspec-explore

Guide open-ended thinking sessions with questions and ASCII diagrams.

Community
Intermediate
tungnguyen10tungnguyen10

openspec-onboard

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

Community
Advanced