Linear

Files (62)

• plugin.json · .claude-plugin/
• .env.schema
• ci.yml · .github/workflows/
• release.yml · .github/workflows/
• .gitignore
• .nvmrc
• CHANGELOG.md
• CLAUDE.md
• LICENSE
• README.md
• SKILL.md
• api.md
• issue-template.md · docs/
• labels.md · docs/
• eslint.config.js
• post-edit.sh · hooks/
• package-lock.json
• package.json
• projects.md
• release.config.js
• bulk-create.test.ts · scripts/__tests__/
• issue-description.test.ts · scripts/__tests__/
• lin-cli.test.ts · scripts/__tests__/
• lint-issues.test.ts · scripts/__tests__/
• retry.test.ts · scripts/__tests__/
• smoke.test.ts · scripts/__tests__/
• validate-description.test.ts · scripts/__tests__/
• build.mjs · scripts/
• bulk-create.ts · scripts/
• create-initiative-update.ts · scripts/
• create-issue-with-project.ts · scripts/
• create-project-update.ts · scripts/
• extract-image.ts · scripts/
• agent-selection.ts · scripts/lib/
• exit-codes.ts · scripts/lib/
• index.ts · scripts/lib/
• initiative.ts · scripts/lib/
• issue-description.ts · scripts/lib/
• labels.ts · scripts/lib/
• lin-cli.ts · scripts/lib/
• linear-utils.ts · scripts/lib/
• project-template.ts · scripts/lib/
• retry.ts · scripts/lib/
• taxonomy-data.ts · scripts/lib/
• taxonomy-validation.ts · scripts/lib/
• taxonomy.ts · scripts/lib/
• verify.ts · scripts/lib/
• linear-api.mjs · scripts/
• linear-ops.ts · scripts/
• lint-issues.ts · scripts/
• phase-complete.ts · scripts/
• query.sh · scripts/
• query.ts · scripts/
• run.sh · scripts/
• setup.ts · scripts/
• sync-skill-version.mjs · scripts/
• sync.ts · scripts/
• upload-image.ts · scripts/
• sdk.md
• sync.md
• …and 2 more

SKILL.md (first lines)

# Linear

Tools and workflows for managing issues, projects, and teams in Linear.

---

## ⚠️ Tool Availability (READ FIRST)

**This skill supports multiple tool backends. Use whichever is available:**

1. **MCP Tools (mcp__linear)** - Use if available in your tool set
2. **Linear CLI (`linear` command)** - Always available via Bash
3. **Helper Scripts** - For complex operations

**If MCP tools are NOT available**, use the Linear CLI via Bash:

```bash
# View an issue
linear issues view ENG-123

# Create an issue
linear issues create --title "Issue title" --description "Description"

# Update issue status (get state IDs first)
linear issues update ENG-123 -s "STATE_ID"

# Add a comment
linear issues comment add ENG-123 -m "Comment text"

# List issues
linear issues list
```

**Do NOT report "MCP tools not available" as a blocker** - use CLI instead.

---

## 🔐 Security: Varlock Integration

**CRITICAL**: Never expose API keys in terminal output or Claude's context.

### Safe Commands (Always Use)

```bash
# Validate LINEAR_API_KEY is set (masked output)
varlock load 2>&1 | grep LINEAR

# Run commands with secrets injected
varlock run -- npm run query -- "query { viewer { name } }"

# Check schema (safe - no values)
cat .env.schema | grep LINEAR
```

### Unsafe Commands (NEVER Use)

```bash
# ❌ NEVER - exposes key to Claude's context
linear config show
echo $LINEAR_API_KEY
printenv | grep LINEAR
cat .env
```

### Setup for New Projects

1. Create `.env.schema` with `@sensitive` annotation:
   ```bash
   # @type=string(startsWith=lin_api_) @required @sensitive
   LINEAR_API_KEY=
   ```

2. Add `LINEAR_API_KEY` to `.env` (never commit this file)

3. Configure MCP to use environment variable:
   ```json
   {
     "mcpServers": {
       "linear": {
         "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
       }
     }
   }
   ```

4. Use `varlock load` to validate before operations

---

## Quick Start (First-Time Users)

### 1. Check Your Setup

Run the setup check to verify your configuration:

```bash
npm run setup
```

This will check:
- LINEAR_API_KEY is set and valid
- @linear/sdk is installed
- Linear CLI availability (optional)
- MCP configuration (optional)

### 2. Get API Key (If Needed)

If setup reports a missing API key:

1. Open [Linear](https://linear.app) in your browser
2. Go to **Settings** (gear icon) -> **Security & access** -> **Personal API keys**
3. Click **Create key** and copy the key (starts with `lin_api_`)
4. Add to your environment:

```bash
# Option A: Add to shell profile (~/.zshrc or ~/.bashrc)
export LINEAR_API_KEY="lin_api_your_key_here"

# Option B: Add to Claude Code environment

From wrsmith108/linear-claude-skill, MIT.