Linear Assistant - Setup Wizard

Welcome! I'll help you create a personalized Linear workflow skill.

Your Linear Identity

• Username: $LINEARUSERNAME (from .env)
• API Key: configured ✓

I'll set this up in 3 simple steps.

Step 1: Discover Your Teams

Let me find your Linear teams by executing the CLI:

node "$PLUGIN_ROOT/dist/cli.js" list-teams --json

(Running this now...)

Step 2: Tell Me About Your Workflow

Based on the teams you see, I need to know:

1. Which team do you want to work with? (name or ID)

- Example: "ASCOP" or "7d832321-d9bc-41bd-aeca-aa1f2675d5da"

1. What's your role or skill name? (this names your workflow skill)

- Examples: "pm-workflow", "dev-workflow", "ralph-automation", "qa-review" - Default: linear-{team}-workflow - Why? A team might have PMs, devs, QA — each with different workflows!

1. How do you work with Linear? (describe your exact workflow)

- Example: "I review client todos, analyze requirements, update titles and descriptions, then assign to developers"

1. Which workflow preset fits you best?

- Review & Analyze: Review todos → analyze → update → assign → move to In Review - Ralph Agent: Get todos → create Ralph tasks → track in Linear → close when done - Custom: Use your own workflow description

Step 3: I'll Set Everything Up

Once you answer the questions, I'll:

1. Generate your personalized skill with:

- Your team name & ID pre-filled - Your workflow description - All 9 Linear CLI commands documented - Preset steps (if you chose one)

1. Create the skill file at:

`` .claude/skills/{skill-name}/SKILL.md ` Example: .claude/skills/linear-pm-workflow/SKILL.md`

1. Auto-load the skill by adding this to .claude/CLAUDE.md:

`` /skill {skill-name} `` So it loads automatically every session!

1. Tell you how to start using it

No copy/paste needed - everything is automatic!

Example

If you tell me:

Team: ASCOP
Team ID: 7d832321-d9bc-41bd-aeca-aa1f2675d5da
Skill Name: linear-pm-workflow
Workflow: Review client todos, analyze requirements, update descriptions, assign to developers
Preset: Review & Analyze

I'll:

1. Create .claude/skills/linear-pm-workflow/SKILL.md with:

- Your team ID pre-filled - Your workflow description - Review & Analyze preset steps - All 9 Linear commands documented

1. Update .claude/CLAUDE.md to add:

`` /skill linear-pm-workflow ``

1. Next session, the skill loads automatically!

Multiple Workflows on Same Team?

If a PM and a Dev both work on ASCOP:

• PM creates: linear-pm-workflow
• Dev creates: linear-dev-workflow
• QA creates: linear-qa-review

Each loads automatically, each has their own workflow! ✨

The generated skill will include:

---
name: linear-ascop-workflow
description: Linear workflow for ASCOP team
---

# Linear ASCOP Workflow

Team: **ASCOP** (ID: `7d832321-d9bc-41bd-aeca-aa1f2675d5da`)

## Your Workflow

> Review client todos, analyze requirements, update descriptions, assign to developers

## Available Commands

[All 9 commands documented with your team ID pre-filled]

## Review & Analyze Workflow

Step 1: List todos
Step 2: Review each
Step 3: Update and assign
...

Ready?

Tell me:

1. Your team (name or ID from the list below)
2. Your workflow (in your own words)
3. Preset (Review & Analyze / Ralph Agent / Custom)

I'll create the skill file automatically and tell you how to load it! ✨

Get Your Teams

Run this command from your project root to see your available teams:

node "$PLUGIN_ROOT/dist/cli.js" list-teams --json

Then tell me which team you want to use.

Instructions for Me (Claude)

See init-wizard/GENERATION_GUIDE.md for how to:

1. Collect user answers
2. Generate the skill content from the template
3. Create the skill file automatically
4. Tell user how to load it