Linear

Overview

This skill provides a structured workflow for managing issues, projects & team workflows in Linear. It ensures consistent integration with the Linear MCP server, which offers natural-language project management for issues, projects, documentation, and team collaboration.

Prerequisites

• Linear MCP server must be connected and accessible via OAuth
• Confirm access to the relevant Linear workspace, teams, and projects

Required Workflow

Follow these steps in order. Do not skip steps.

Step 0: Set up Linear MCP (if not already configured)

If any MCP call fails because Linear MCP is not connected, pause and set it up:

1. Add the Linear MCP:
   • codex mcp add linear --url https://mcp.linear.app/mcp
2. Enable remote MCP client:
   • Set [features] rmcp_client = true in config.toml or run codex --enable rmcp_client
3. Log in with OAuth:
   • codex mcp login linear

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

Windows/WSL note: If you see connection errors on Windows, try configuring the Linear MCP to run via WSL:

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}

Step 1

Clarify the user's goal and scope (e.g., issue triage, sprint planning, documentation audit, workload balance). Confirm team/project, priority, labels, cycle, and due dates as needed.

Step 2

Select the appropriate workflow (see Practical Workflows below) and identify the Linear MCP tools you will need. Confirm required identifiers (issue ID, project ID, team key) before calling tools.

Step 3

Execute Linear MCP tool calls in logical batches:

• Read first (list/get/search) to build context.
• Create or update next (issues, projects, labels, comments) with all required fields.
• For bulk operations, explain the grouping logic before applying changes.

Step 4

Summarize results, call out remaining gaps or blockers, and propose next actions (additional issues, label changes, assignments, or follow-up comments).

Available Tools

Issue Management: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Project & Team: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Documentation & Collaboration: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Practical Workflows

• Sprint Planning: Review open issues for a target team, pick top items by priority, and create a new cycle (e.g., "Q1 Performance Sprint") with assignments.
• Bug Triage: List critical/high-priority bugs, rank by user impact, and move the top items to "In Progress."
• Documentation Audit: Search documentation (e.g., API auth), then open labeled "documentation" issues for gaps or outdated sections with detailed fixes.
• Team Workload Balance: Group active issues by assignee, flag anyone with high load, and suggest or apply redistributions.
• Release Planning: Create a project (e.g., "v2.0 Release") with milestones (feature freeze, beta, docs, launch) and generate issues with estimates.
• Cross-Project Dependencies: Find all "blocked" issues, identify blockers, and create linked issues if missing.
• Automated Status Updates: Find your issues with stale updates and add status comments based on current state/blockers.
• Smart Labeling: Analyze unlabeled issues, suggest/apply labels, and create missing label categories.
• Sprint Retrospectives: Generate a report for the last completed cycle, note completed vs. pushed work, and open discussion issues for patterns.

Tips for Maximum Productivity

• Batch operations for related changes; consider smart templates for recurring issue structures.
• Use natural queries when possible ("Show me what John is working on this week").
• Leverage context: reference prior issues in new requests.
• Break large updates into smaller batches to avoid rate limits; cache or reuse filters when listing frequently.

Troubleshooting

• Authentication: Clear browser cookies, re-run OAuth, verify workspace permissions, ensure API access is enabled.
• Tool Calling Errors: Confirm the model supports multiple tool calls, provide all required fields, and split complex requests.
• Missing Data: Refresh token, verify workspace access, check for archived projects, and confirm correct team selection.
• Performance: Remember Linear API rate limits; batch bulk operations, use specific filters, or cache frequent queries.

WebGPU Three.js with TSL

TSL (Three.js Shading Language) is a node-based shader abstraction that lets you write GPU shaders in JavaScript instead of GLSL/WGSL strings.

Quick Start

import * as THREE from 'three/webgpu';
import { color, time, oscSine } from 'three/tsl';

const renderer = new THREE.WebGPURenderer();
await renderer.init();

const material = new THREE.MeshStandardNodeMaterial();
material.colorNode = color(0xff0000).mul(oscSine(time));

Skill Contents

Documentation

• docs/core-concepts.md - Types, operators, uniforms, control flow
• docs/materials.md - Node materials and all properties
• docs/compute-shaders.md - GPU compute with instanced arrays
• docs/post-processing.md - Built-in and custom effects
• docs/wgsl-integration.md - Custom WGSL functions
• docs/device-loss.md - Handling GPU device loss and recovery
• docs/limits-and-features.md - WebGPU device limits and optional features

Examples

• examples/basic-setup.md - Minimal WebGPU project
• examples/custom-material.md - Custom shader material
• examples/particle-system.md - GPU compute particles
• examples/post-processing.md - Effect pipeline
• examples/earth-shader.md - Complete Earth with atmosphere

Templates

• templates/webgpu-project.md - Starter project template
• templates/compute-shader.md - Compute shader template

Reference

• REFERENCE.md - Quick reference cheatsheet

Key Concepts

Import Pattern

// Always use the WebGPU entry point
import * as THREE from 'three/webgpu';
import { /* TSL functions */ } from 'three/tsl';

Node Materials

Replace standard material properties with TSL nodes:

material.colorNode = texture(map);        // instead of material.map
material.roughnessNode = float(0.5);      // instead of material.roughness
material.positionNode = displaced;         // vertex displacement

Method Chaining

TSL uses method chaining for operations:

// Instead of: sin(time * 2.0 + offset) * 0.5 + 0.5
time.mul(2.0).add(offset).sin().mul(0.5).add(0.5)

Custom Functions

Use Fn() for reusable shader logic:

const fresnel = Fn(([power = 2.0]) => {
  const nDotV = normalWorld.dot(viewDir).saturate();
  return float(1.0).sub(nDotV).pow(power);
});

When to Use This Skill

• Setting up Three.js with WebGPU renderer
• Creating custom shader materials with TSL
• Writing GPU compute shaders
• Building post-processing pipelines
• Migrating from GLSL to TSL
• Implementing visual effects (particles, water, terrain, etc.)

Resources

• Three.js TSL Wiki
• WebGPU Examples (files prefixed with webgpu_)