/ 目錄 / 演練場 / linear-claude-skill
← 全部伺服器 ↗ GitHub
● 社群 wrsmith108 ⚡ 即開即用

linear-claude-skill

作者 wrsmith108 · wrsmith108/linear-claude-skill

A Claude skill that teaches the agent how to manage Linear issues, projects, and cycles through the Linear MCP and SDK.

Clone this skill into ~/.claude/skills/ and Claude gets a working mental model of Linear — teams, cycles, issue states, GraphQL queries, and common automations. It wraps the Linear MCP (or direct SDK calls) with opinionated patterns so the agent does triage, rollovers, and project reporting without reinventing the API each turn.

▶ 觀看演示 📦 安裝 💡 使用場景

為什麼要用

核心特性

即時演示

實際使用效果

linear-claude-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linear-claude-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "linear-claude-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wrsmith108/linear-claude-skill",
        "~/.claude/skills/linear-claude-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "linear-claude-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/wrsmith108/linear-claude-skill",
          "~/.claude/skills/linear-claude-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add linear-claude-skill -- git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： linear-claude-skill

How to run a weekly Linear cycle review with Claude

👤 Engineering managers and tech leads on a Linear team ⏱ ~15 min beginner

何時使用： Friday afternoon, you need to know what shipped this cycle, what slipped, and what to roll over.

前置條件
  • Linear API key or Linear MCP installed — linear.app/settings/api — create a personal API key
  • Skill cloned — git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill
步驟
  1. Ask Claude to pull the current cycle
    Show me every issue in the current cycle for team ENG — grouped by state, with the assignee.✓ 已複製
    → Table: Backlog / In Progress / In Review / Done with issue IDs
  2. Diagnose slips
    Which issues are still In Progress or In Review with 2 days left? Who owns them?✓ 已複製
    → Per-issue one-liner with risk call-out
  3. Roll over and write the recap
    Roll incomplete issues into the next cycle and draft a Slack recap of what actually shipped.✓ 已複製
    → Confirmation of the rollover + paste-ready recap

結果： A clean cycle close-out in 10 minutes instead of an hour.

注意事項
  • Claude rolls over issues you meant to cancel — Tell it 'list first, confirm, then mutate' — keep a human checkpoint before writes
搭配使用： github · slack

Triage the bug inbox with prioritization rationale

👤 On-call engineers, tech leads ⏱ ~25 min intermediate

何時使用： Monday morning, the Bugs project has 40 untriaged items and you need to cut the list.

步驟
  1. List untriaged bugs
    Find all issues in project 'Bugs' with no priority and no assignee, created in the last 14 days.✓ 已複製
    → Ranked table with titles
  2. Suggest priority + owner
    For each, suggest priority (Urgent/High/Medium/Low) and the most-likely team based on the file paths or labels mentioned.✓ 已複製
    → Reasoned suggestions, not blanket Medium
  3. Apply the decisions
    Apply those priorities and assign to the suggested teams. Confirm before each write.✓ 已複製
    → Per-issue confirmation

結果： A fully triaged bug inbox with traceable reasoning per issue.

注意事項
  • Mass-assigning to one person who happens to show up in the last few commits — Limit assignments to team-level, not individual — cheaper to fix later
搭配使用： github

Generate a project status update from Linear

👤 PMs and TPMs running multi-cycle projects ⏱ ~15 min beginner

何時使用： Before a status review meeting or async update to stakeholders.

步驟
  1. Gather project state
    Summarize project 'Mobile v2.0': issue counts by state, % complete, and what's changed since last Monday.✓ 已複製
    → Numeric snapshot + delta
  2. Call out risks
    List the top 3 risks — issues blocked, overdue, or with no owner.✓ 已複製
    → Ranked risks with why
  3. Draft the update
    Write a 5-bullet status update: progress, shipped this week, next week, risks, asks.✓ 已複製
    → Paste-ready paragraph or bullets

結果： A crisp stakeholder update you didn't have to write yourself.

注意事項
  • Updates become uniformly 'on track' — Force Claude to pick actual risks from stale issues; don't let it round to green
搭配使用： github

組合

與其他 MCP 搭配，撬動十倍槓桿

linear-claude-skill + github

Mirror GitHub issue activity into Linear for tracking

For every issue closed in octocat/api this week, mark the matching Linear issue as Done and leave a comment linking to the PR.✓ 已複製
linear-claude-skill + sentry

Auto-file Linear bugs from Sentry alerts with proper priority

For every Sentry issue marked 'unresolved' with >100 events today, create a Linear bug in the BACKEND team at High priority.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
cycle-reporting team, cycle selector You need a snapshot of a cycle N Linear API calls (read-only)
issue-triage filter (project, state, labels) Weekly bug or backlog grooming Read-only until user confirms writes
issue-creation title, description, team, priority, labels Filing structured issues from meeting notes or Sentry/GitHub events 1 write per issue
project-status project id Before stakeholder updates Read-only

成本與限制

運行它的成本

API 配額
Linear API: 1500 requests / hour on personal keys
每次呼叫 Token 數
200–2000 tokens per report step
費用
Free — Linear Free and Standard plans both support API access
提示
Batch GraphQL fields in one query — saves both rate limit and token budget

安全

權限、密鑰、影響範圍

最小權限： read
憑證儲存： Linear API key in env var (LINEAR_API_KEY). Never paste into the prompt.
資料出站： api.linear.app only
切勿授予： admin (org-wide write)

故障排查

常見錯誤與修復

Skill doesn't activate

Ensure SKILL.md exists at ~/.claude/skills/linear-claude-skill/SKILL.md and restart Claude Code.

驗證： ls ~/.claude/skills/linear-claude-skill/
401 from Linear API

Regenerate the API key in linear.app/settings/api; make sure LINEAR_API_KEY is exported in the shell Claude Code runs in.

驗證： echo $LINEAR_API_KEY | head -c 6
Rate limit hit during a big report

Ask Claude to paginate with fewer fields; or split the report by team.

替代方案

linear-claude-skill 對比其他方案

替代方案何時用它替代權衡
Linear MCP (official)You want a JSON-RPC tool surface rather than a prompt skillMCP gives real tools; skill gives better defaults and reporting prose
Jira skillYour team uses Jira instead of LinearDifferent data model entirely

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills