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:

   code

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

   code

   /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:

   code

   /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