# openspec-onboard

> Claude/Codex skill by [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars · Updated 2026-10-17

Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work. Also use when the user says "openspec onboard" or "opsx onboard".

Tags: ai, context-engineering, engineering, planning, prd, sdd, sdlc, spec, spec-driven-development, specification

## Install

```sh
git clone https://github.com/Fission-AI/OpenSpec /tmp/OpenSpec && ln -s /tmp/OpenSpec/skills/openspec-onboard ~/.claude/skills/openspec-onboard
```

## From README

Preflight Before starting, check if the OpenSpec CLI is installed: If CLI not installed: OpenSpec CLI is not installed. it first, then come back to /openspec-onboard. Stop here if not installed. --- Phase 1: Welcome Display: --- Phase 2: Task Selection Codebase Analysis Scan the codebase for small improvement opportunities. Look for: TODO/FIXME comments - Search for TODO, FIXME, HACK, XXX in code files Missing error handling - catch blocks that swallow errors, risky operations without try-catch Functions without tests - Cross-reference src/ with test directories Type issues - any types in TypeScript files (: any, as any) Debug artifacts - console.log, console.debug, debugger statements in non-debug code Missing validation - User input handlers without validation Also check recent git activity: Present Suggestions From your analysis, present 3-4 specific suggestions: If nothing found: Fall back to asking what the user wants to build: I didn't find obvious quick wins in your codebase.

## Links

- HTML page: https://omgskills.com/skills/fission-ai/openspec/openspec-onboard/
- GitHub: https://github.com/Fission-AI/OpenSpec
- Author: [@fission-ai](https://omgskills.com/library/fission-ai/index.md)

## More from this repo

- [draft-openspec-docs](https://omgskills.com/skills/fission-ai/openspec/draft-openspec-docs/index.md) — Collaborative page-drafting mode for the OpenSpec docs.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 73k stars
- [openspec-apply-change](https://omgskills.com/skills/fission-ai/openspec/openspec-apply-change/index.md) — Implement tasks from an OpenSpec change.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars
- [openspec-archive-change](https://omgskills.com/skills/fission-ai/openspec/openspec-archive-change/index.md) — Archive a completed OpenSpec change in the experimental workflow.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars