linear-claude-skill MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Encodes Linear's data model: Teams → Projects → Cycles → Issues → SubIssues
Ready-made GraphQL query snippets for the most common reports
Priority, state, and label conventions that the agent applies consistently
Works alongside the official Linear MCP for writes
Markdown-only skill — no runtime dependencies to install

Живое демо

Как выглядит на практике

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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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

Поток

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
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
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.

Поток

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
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
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.

Поток

Gather project state

Summarize project 'Mobile v2.0': issue counts by state, % complete, and what's changed since last Monday.✓ Скопировано

→ Numeric snapshot + delta
Call out risks

List the top 3 risks — issues blocked, overdue, or with no owner.✓ Скопировано

→ Ranked risks with why
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 — эффект x10

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
Токенов на вызов: 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)

Issues, projects, and cycles may contain confidential roadmap info — think twice before pasting into external tools.

Устранение неполадок

Частые ошибки и исправления

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 skill	MCP gives real tools; skill gives better defaults and reporting prose
Jira skill	Your team uses Jira instead of Linear	Different data model entirely

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills