openspec-onboard
Guided onboarding through the complete OpenSpec workflow using `/opsx:onboard`, walking the user through a real change in their codebase. Use when the user says "onboard me", "tutorial", "/opsx:onboard", "how does OpenSpec work", or is new to OpenSpec.
How do I install this agent skill?
npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboardIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a guided onboarding workflow for the OpenSpec tool. It involves analyzing the user's local codebase to suggest improvements, which introduces a potential surface for indirect prompt injection if the analyzed files contain malicious instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
OpenSpec Onboard Skill
Use /opsx:onboard for a guided, interactive tutorial through the complete OpenSpec workflow. The tutorial uses the user's actual codebase — finding real improvement opportunities, creating a real change, implementing it, and archiving it.
When to Use
- First-time OpenSpec users who want a hands-on walkthrough.
- The user says "onboard", "tutorial", "show me how OpenSpec works".
- Learning the workflow before using it on real work.
Prerequisites
- OpenSpec initialized in the project (see openspec-initial).
Workflow
-
Start onboarding
- Run
/opsx:onboard.
- Run
-
Tutorial phases
- Welcome and codebase analysis.
- Finding an improvement opportunity (small, safe changes).
- Creating a change (
/opsx:new). - Writing the proposal.
- Creating specs.
- Writing the design.
- Creating tasks.
- Implementing tasks (
/opsx:apply). - Verifying implementation.
- Archiving the change.
- Summary and next steps.
-
Interactive
- The agent explains each step as it happens.
- The user chooses which improvement to work on.
- The change created is real and can be kept or discarded.
Outputs
- A complete change cycle (from proposal to archive) using the user's actual codebase.
- The user has first-hand experience with every OPSX command.
Next Steps
- Start real work with openspec-new or openspec-explore.
Troubleshooting
- "Commands not recognized": Ensure OpenSpec is initialized (
openspec init). See openspec-initial. - Takes too long: The tutorial covers the full workflow; expect 15-30 minutes.
References
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/full-stack-skills/openspec-skills/openspec-onboard">View openspec-onboard on skillZs</a>