Linear Assistant - Setup Wizard

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

Your Linear Identity

• Username: $LINEAR_USER_NAME (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"

2. 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!

3. 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"

4. 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)

2. Create the skill file at:

   .claude/skills/{skill-name}/SKILL.md
   

   Example: .claude/skills/linear-pm-workflow/SKILL.md

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

   /skill {skill-name}
   

   So it loads automatically every session!

4. 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

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

   /skill linear-pm-workflow
   

3. 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