openspec-onboard

Q: How do I install openspec-onboard?

Run npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/openspec-onboard/ (personal) or .claude/skills/openspec-onboard/ (project).

by full-stack-skillsCode Quality & Workflow

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.

Installs: 102
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads openspec-onboard automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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.
Tutorial phases
1. Welcome and codebase analysis.
2. Finding an improvement opportunity (small, safe changes).
3. Creating a change (/opsx:new).
4. Writing the proposal.
5. Creating specs.
6. Writing the design.
7. Creating tasks.
8. Implementing tasks (/opsx:apply).
9. Verifying implementation.
10. Archiving the change.
11. 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

OpenSpec Commands: /opsx:onboard

FAQ

What does the openspec-onboard skill do?

How do I install openspec-onboard?

Run npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/openspec-onboard/ (personal) or .claude/skills/openspec-onboard/ (project).

Which AI agents can use openspec-onboard?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is openspec-onboard safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains openspec-onboard?

It is published by full-stack-skills in full-stack-skills/openspec-skills. It has 102 recorded installs.