linearlisted
Install: claude install-skill ulises-jeremias/agent-toolkit
# Linear
Structured workflow for managing Linear issues, projects and cycles through the
official Linear MCP server (`https://mcp.linear.app/mcp`, OAuth).
This skill assumes the MCP is wired into your AI tool. See
[`docs/MCP_TEMPLATES.md`](../../../../../../docs/MCP_TEMPLATES.md) and
`~/.local/share/agent-toolkit/mcp/linear/` for the managed template.
## When to use
- "Open a Linear ticket for X", "triage open bugs", "plan the next cycle".
- Sprint/cycle planning, retrospectives, documentation audits.
- Cross-project dependency review or workload rebalancing.
- Any natural-language request that maps onto Linear's MCP toolset.
## Prerequisites
1. Linear MCP server connected via OAuth in your AI tool of choice.
2. Workspace access to the relevant teams and projects.
3. agent-toolkit template available at `~/.local/share/agent-toolkit/mcp/linear/`
(deployed by `chezmoi apply`).
## Setup (per AI tool)
The Linear MCP is a **streamable HTTP** endpoint with OAuth. Register it in
your AI tool of choice using the agent-toolkit template as reference:
| AI tool | Where to register |
|---------|-------------------|
| Claude Code | `~/.claude/mcp.json` (or via `claude mcp add`) |
| Cursor | `~/.cursor/mcp.json` |
| OpenCode | `~/.config/opencode/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
Copy `~/.local/share/agent-toolkit/mcp/linear/config.template.json` into the right
location and follow the OAuth prompt the first time you call a Linear tool.
> Windows