# Openspec Onboard

Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration...

- Repository: https://github.com/fengshao1227/ccg-workflow (5956 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add fengshao1227/ccg-workflow --skill openspec-onboard -g -a claude-code -y`
Codex: `npx skills add fengshao1227/ccg-workflow --skill openspec-onboard -g -a codex -y`
Cursor: `npx skills add fengshao1227/ccg-workflow --skill openspec-onboard -g -a cursor -y`
Gemini CLI: `npx skills add fengshao1227/ccg-workflow --skill openspec-onboard -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add fengshao1227/ccg-workflow`

## Description

Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Guide the user through their first complete OpenSpec workflow cycle. This is a teaching experience, you'll do real work in their codebase while explaining each step.

---

## Preflight

Before starting, check if OpenSpec is initialized:

```bash
openspec status --json 2>&1 || echo "NOT_INITIALIZED"
```

**If not initialized:**
> OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx:onboard`.

Stop here if not initialized.

---

## Phase 1: Welcome

Display:

```
## Welcome to OpenSpec!

I'll walk you through a complete change cycle, from idea to implementation, using a real task in your codebase. Along the way, you'll learn the workflow by doing it.

**What we'll do:**
1. Pick a small, real task in your codebase
2. Explore the problem briefly
3. Create a change (the container for our work)
4. Build the artifacts: proposal → specs → design → tasks
5. Implement the tasks
6. Archive the completed change

**Time:** ~15-20 minutes

Let's start by finding something to work on.
```

---

## Phase 2: Task Selection

### Codebase Analysis

Scan the codebase for small improvement opportunities. Look for:

1. **TODO/FIXME comments** - Search for `TODO`, `FIXME`, `HACK`, `XXX` in code files
2. **Missing error handling** - `catch` blocks that swallow errors, risky operations without try-catch
3. **Functions without tests** - Cross-reference `src/` with test directories
4. **Type issues** - `any` types in TypeScript files (`: any`, `as any`)
5. **Debug artifacts** - `console.log`, `console.debug`, `debugger` statements in non-debug code
6. **Missing validation** - User input handlers without validation

Also check recent git activity:
```bash
git log --oneline -10 2>/dev/null || echo "No git history"
```

### Present Suggestions

From your analysis, present 3-4 specific suggestions:

```
## Task Suggestions

Based on scanning your codebase, here are some good starter tasks:

The rest: https://github.com/fengshao1227/ccg-workflow/blob/HEAD/.agents/skills/openspec-onboard/SKILL.md