linear · davila7 — Claude Code skill: what it does, how to install
Orchestrates Linear issue tracking, sprint planning, and team workflows directly within Claude Code using MCP tools.
npx claude-code-templates@latest --skill productivity/linearWhat linear does
This skill guides the agent through an ordered process for project tracking. It prevents messy edits. The model first clarifies scope, collects target identifiers, reads issues, and only then executes modifications in batches before delivering a final summary.
Predefined workflows cover backlog triage, release milestones, documentation audits, and cycle balance. The assistant relies on Linear MCP endpoints to inspect and modify tickets, project cycles, labels, and discussion comments.
Direct operations fail without an active OAuth session on the Linear MCP server. Windows setups experiencing transport drops require routing the MCP command through WSL using mcp-remote.
What it helps with
- triage high-priority bugs and assign active states
- structure new sprint cycles and distribute team workload
- locate stale tickets to add progress comments
- audit project documentation and file tracking issues for missing sections
Example prompts for the agent
- List all urgent issues for our backend team and move the first two to in progress
- Review assignee workloads for the active cycle and highlight overloaded members
- Plan a new release milestone with issues for beta testing and documentation
How to install linear
1claude-code-templates
npx claude-code-templates@latest --skill productivity/linear2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill linear -a claude-code3Manually: put the files in place
~/.claude/skills/linear/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linear/
Manually: put the files in place
.agents/skills/linear/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/linear/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates linear2Manually: put the files in place
.github/skills/linear/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/linearManually: put the files in place
.devin/skills/linear/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linear
How to install linear in Claude Code?
Run npx claude-code-templates@latest --skill productivity/linear in your terminal to install the skill.
What does the linear skill do?
It establishes a sequential workflow for managing Linear workspace tickets, cycles, and projects. Claude gathers team context, inspects existing entries first, and executes structured batch updates.
What prerequisites are needed before using it?
You need a connected Linear MCP server at https://mcp.linear.app/mcp authorized with OAuth. On Windows, connection issues might require tunneling the MCP runner through WSL.
Similar skills
All skills for Notes, tasks and projects →linear by other authors comes first.