Linear Assistant - Setup Wizard

Welcome! I'll help you create a personalized Linear workflow skill in 3 simple steps.

Step 1: Discover Your Teams

Let me find your Linear teams:

bash

linear list-teams --json

What teams do you see? (or paste the JSON output if you already ran it)

Step 2: Tell Me About Your Workflow

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

•
Which team do you want to work with? (name or ID)
- •Example: "ASCOP" or "7d832321-d9bc-41bd-aeca-aa1f2675d5da"
•
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!
•
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"
•
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:

•
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)
•
Create the skill file at:
code
```
.claude/skills/{skill-name}/SKILL.md
```
Example: .claude/skills/linear-pm-workflow/SKILL.md
•
Auto-load the skill by adding this to .claude/CLAUDE.md:
code
```
/skill {skill-name}
```
So it loads automatically every session!
•
Tell you how to start using it

No copy/paste needed - everything is automatic!

Example

If you tell me:

code

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:

•
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
•
Update .claude/CLAUDE.md to add:
code
```
/skill linear-pm-workflow
```
•
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:

markdown

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

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

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

Get Your Teams

First, run this to see your available teams:

bash

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

•Collect user answers
•Generate the skill content from the template
•Create the skill file automatically
•Tell user how to load it