linear-claude-skill

Name: linear-claude-skill
Author: wrsmith108

bywrsmith108· 1 MCP server

Stars

118

Forks

How to install linear-claude-skill?

wrsmith108/linear-claude-skill

$git clone https://github.com/wrsmith108/linear-claude-skill

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install linear-claude-skill by running `git clone https://github.com/wrsmith108/linear-claude-skill`, then use it for the current task and follow its documentation at https://github.com/wrsmith108/linear-claude-skill.

Files · 1

View on GitHub

README.md

1	# Linear Skill for Claude Code
2
3	A comprehensive [Claude Code](https://claude.ai/code) skill for managing Linear issues, projects, and teams. Provides patterns for MCP tools, SDK automation, and GraphQL API access.
4
5	## Features
6
7	- esbuild Pre-compilation — 18x faster CLI startup (~50ms vs ~1s) with transparent tsx fallback via shared `scripts/run.sh`
8	- Label Taxonomy System — Domain-based labels for consistent categorization and agent routing
9	- First-Time Setup Check — Automatic configuration validation with actionable guidance
10	- High-Level Operations — Simple commands for initiatives, projects, and status updates
11	- Sub-Issue Management — Create and manage parent-child issue relationships
12	- Discovery Before Creation — Mandatory checks to prevent duplicate projects/issues
13	- MCP Tool Integration — Simple operations via Linear MCP server
14	- SDK Automation — Complex operations with TypeScript scripts
15	- GraphQL API — Direct API access for advanced queries
16	- Project Management — Content, descriptions, milestones, resource links
17	- Bulk Sync — Synchronize code changes with Linear via CLI, agents, or hooks
18	- Image Uploads — Upload images to Linear's S3 storage and attach to issues
19	- Smoke Tests — Automated verification of build output and CLI behavior
20	- `lin` CLI Integration — Optional fast-path via [aaronkwhite/linear-cli](https://github.com/aaronkwhite/linear-cli) Rust binary with silent SDK fallback
21
22	## Quick Start (New Users)
23
24	### 1. Install the Skill
25
26	```bash
27	git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
28	cd ~/.claude/skills/linear && npm install
29	```
30
31	### 2. Run Setup Check
32
33	```bash
34	npm run setup
35	```
36
37	This checks your configuration and tells you exactly what's missing.
38
39	### 3. Get Your API Key (If Needed)
40
41	1. Open [Linear](https://linear.app) in your browser
42	2. Go to Settings → Security & access → Personal API keys
43	3. Click Create key and copy it (starts with `lin_api_`)
44	4. Add to your environment:
45
46	```bash
47	# Add to shell profile
48	echo 'export LINEAR_API_KEY="lin_api_your_key_here"' >> ~/.zshrc
49	source ~/.zshrc
50	```
51
52	### 4. Verify It Works
53
54	```bash
55	npm run ops -- whoami
56	```
57
58	You should see your name and organization.
59
60	### 5. Build for Faster Startup (Optional)
61
62	```bash
63	npm run build
64	```
65
66	Pre-compiles TypeScript to JavaScript for ~18x faster CLI cold starts. Without building, commands still work via tsx (slower but functional).
67
68	### 6. Start Using It
69
70	```bash
71	# Create an initiative
72	npm run ops -- create-initiative "My Project"
73
74	# Create a project
75	npm run ops -- create-project "Phase 1" "My Project"
76
77	# Create a sub-issue under a parent
78	npm run ops -- create-sub-issue ENG-100 "Add tests" "Unit tests for feature"
79
80	# Set parent-child relationships for existing issues
81	npm run ops -- set-parent ENG-100 ENG-101 ENG-102
82
83	# Update issue status
84	npm run ops -- status Done ENG-123 ENG-124
85
86	# See all commands
87	npm run ops -- help
88	```
89
90	---
91
92	## Installation
93
94	```bash
95	# Clone directly to your skills directory
96	git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
97	cd ~/.claude/skills/linear && npm install
98	```
99
100	## Prerequisites
101
102	- Linear API Key — Generate at Linear → Settings → Security & access → Personal API keys
103	- `lin` CLI (Optional) — Faster execution for status updates, search, and listings:
104	```bash
105	brew install aaronkwhite/tap/lin # macOS (Homebrew)
106	cargo install lincli # Any platform with Rust
107	```
108	Set `LINEAR_USE_LIN=0` to disable even when installed.
109	- Linear MCP Server (Recommended) — Use the official Linear MCP server for best reliability:
110
111	```json
112	{
113	"mcpServers": {
114	"linear": {
115	"command": "npx",
116	"args": ["mcp-remote", "https://mcp.linear.app/sse"],
117	"env": {
118	"LINEAR_API_KEY": "your_api_key"
119	}
120	}
121	}
122	}
123	```
124
125	> Important: Always use Linear's official MCP server at `mcp.linear.app`. Do NOT use deprecated community servers like `linear-mcp-server` (npm) or `jerhadf/linear-mcp-server` (GitHub).
126
127	## Directory Structure
128
129	```
130	linear-claude-skill/
131	├── SKILL.md # Main skill instructions (Claude Code discovers this)
132	├── api.md # GraphQL API reference
133	├── sdk.md # SDK automation patterns
134	├── sync.md # Bulk sync patterns
135	├── docs/
136	│ └── labels.md # Label taxonomy documentation
137	├── scripts/
138	│ ├── run.sh # Shared runner (dist/ with tsx fallback)
139	│ ├── build.mjs # esbuild pre-compilation script
140	│ ├── linear-ops.ts # High-level operations (issues, projects, labels)
141	│ ├── query.ts # GraphQL query runner
142	│ ├── setup.ts # Configuration checker
143	│ ├── sync.ts # Bulk sync CLI tool
144	│ ├── upload-image.ts # Upload images to Linear S3
145	│ ├── extract-image.ts # Extract images from session JSONL
146	│ ├── linear-api.mjs # Direct API wrapper
147	│ ├── __tests__/ # Smoke tests (Node built-in tes

6 picks

Type

Install linear-claude-skill by running `git clone https://github.com/wrsmith108/linear-claude-skill`, then use it for the current task and follow its documentation at https://github.com/wrsmith108/linear-claude-skill.

linear-claude-skill

How to install linear-claude-skill?

Related

linear-claude-skill

How to install linear-claude-skill?

Related