/ ディレクトリ / プレイグラウンド / linear-claude-skill
● コミュニティ wrsmith108 ⚡ 即起動

linear-claude-skill

作者 wrsmith108 · wrsmith108/linear-claude-skill

Linear MCP および SDK を通じて Linear の課題、プロジェクト、サイクルを管理する方法をエージェントに教える Claude スキルです。

このスキルを ~/.claude/skills/ にクローンすると、Claude は Linear の全体像(チーム、サイクル、課題ステート、GraphQL クエリ、一般的な自動化)を把握できるようになります。Linear MCP(または直接の SDK 呼び出し)を、意見のあるパターンでラップしているため、エージェントは毎回 API を一から学び直すことなく、トリアージ、ロールオーバー、プロジェクトレポートを実行できます。

なぜ使うのか

主な機能

ライブデモ

実際の動作

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

Claude で週次 Linear サイクルレビューを実施する方法

👤 Linear を利用しているエンジニアリングマネージャーおよびテックリード ⏱ ~15 min beginner

使うタイミング: 金曜日の午後、今サイクルで何がリリースされ、何が遅延し、何をロールオーバーすべきかを把握したいとき。

前提条件
  • Linear API キーまたは Linear MCP のインストール — linear.app/settings/api でパーソナル API キーを作成してください
  • スキルのクローン — git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill
フロー
  1. Claude に現在のサイクルを取得するよう依頼する
    Show me every issue in the current cycle for team ENG — grouped by state, with the assignee.✓ コピーしました
    → テーブル形式: Backlog / In Progress / In Review / Done(課題 ID 付き)
  2. 遅延を診断する
    Which issues are still In Progress or In Review with 2 days left? Who owns them?✓ コピーしました
    → 課題ごとの一行サマリーとリスクの指摘
  3. ロールオーバーを実行し、振り返りを作成する
    Roll incomplete issues into the next cycle and draft a Slack recap of what actually shipped.✓ コピーしました
    → ロールオーバーの確認と、そのまま貼り付けられる振り返り文

結果: 1時間かかっていたサイクルクローズを10分でクリーンに完了できます。

注意点
  • Claude がキャンセルすべき課題までロールオーバーしてしまう — 「まず一覧を出して、確認してから変更して」と指示し、書き込み前に人間のチェックポイントを設けてください
組み合わせ: github · slack

優先度の根拠付きでバグ受信トレイをトリアージする

👤 オンコールエンジニア、テックリード ⏱ ~25 min intermediate

使うタイミング: 月曜の朝、Bugs プロジェクトに未トリアージの項目が40件溜まっていて、リストを整理する必要があるとき。

フロー
  1. 未トリアージのバグを一覧表示する
    Find all issues in project 'Bugs' with no priority and no assignee, created in the last 14 days.✓ コピーしました
    → タイトル付きのランク付けテーブル
  2. 優先度と担当者を提案させる
    For each, suggest priority (Urgent/High/Medium/Low) and the most-likely team based on the file paths or labels mentioned.✓ コピーしました
    → 一律 Medium ではなく、根拠のある提案
  3. 決定を適用する
    Apply those priorities and assign to the suggested teams. Confirm before each write.✓ コピーしました
    → 課題ごとの確認

結果: 課題ごとに追跡可能な判断根拠が付いた、完全にトリアージ済みのバグ受信トレイ。

注意点
  • 直近のコミットにたまたま名前が出てくる一人に大量アサインしてしまう — 個人ではなくチームレベルでアサインしてください — 後から修正するほうがコストが低いです
組み合わせ: github

Linear からプロジェクトステータスアップデートを生成する

👤 複数サイクルにまたがるプロジェクトを運営する PM および TPM ⏱ ~15 min beginner

使うタイミング: ステータスレビュー会議の前や、ステークホルダーへの非同期アップデートの前に。

フロー
  1. プロジェクトの状況を収集する
    Summarize project 'Mobile v2.0': issue counts by state, % complete, and what's changed since last Monday.✓ コピーしました
    → 数値スナップショットと差分
  2. リスクを指摘させる
    List the top 3 risks — issues blocked, overdue, or with no owner.✓ コピーしました
    → 理由付きのランク付けリスク一覧
  3. アップデート文を下書きさせる
    Write a 5-bullet status update: progress, shipped this week, next week, risks, asks.✓ コピーしました
    → そのまま貼り付けられる文章または箇条書き

結果: 自分で書く必要のない、簡潔なステークホルダー向けアップデート。

注意点
  • アップデートが一律「順調」になってしまう — Claude に古くなった課題から実際のリスクを抽出させてください。安易に「問題なし」にまとめさせないこと
組み合わせ: github

組み合わせ

他のMCPと組み合わせて10倍の力を

linear-claude-skill + github

GitHub の課題アクティビティを Linear にミラーリングして追跡する

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

Sentry アラートから適切な優先度で Linear バグを自動起票する

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 サイクルのスナップショットが必要なとき N Linear API calls (read-only)
issue-triage filter (project, state, labels) 週次のバグまたはバックログのグルーミング時 Read-only until user confirms writes
issue-creation title, description, team, priority, labels 会議メモや Sentry/GitHub イベントから構造化された課題を起票するとき 1 write per issue
project-status project id ステークホルダーへのアップデート前 Read-only

コストと制限

運用コスト

APIクォータ
Linear API: パーソナルキーで 1500 リクエスト/時間
呼び出しあたりのトークン
レポートステップごとに 200〜2000 トークン
金額
無料 — Linear の Free プランおよび Standard プランの両方で API アクセスが可能です
ヒント
GraphQL のフィールドを1つのクエリにまとめてください — レートリミットとトークン予算の両方を節約できます

セキュリティ

権限、シークレット、影響範囲

最小スコープ: read
認証情報の保管: Linear API キーは環境変数(LINEAR_API_KEY)に保存してください。プロンプトに直接貼り付けないでください。
データ送信先: api.linear.app のみ
絶対に付与しない: admin (org-wide write)

トラブルシューティング

よくあるエラーと対処法

スキルが有効化されない

~/.claude/skills/linear-claude-skill/SKILL.md が存在することを確認し、Claude Code を再起動してください。

確認: ls ~/.claude/skills/linear-claude-skill/
Linear API から 401 エラー

linear.app/settings/api で API キーを再生成し、Claude Code が実行されるシェルで LINEAR_API_KEY がエクスポートされていることを確認してください。

確認: echo $LINEAR_API_KEY | head -c 6
大規模レポート中にレートリミットに到達

Claude にフィールドを減らしてページネーションするよう指示するか、チームごとにレポートを分割してください。

代替案

linear-claude-skill 他との比較

代替案代わりに使う場面トレードオフ
Linear MCP (official)プロンプトスキルではなく JSON-RPC ツールサーフェスが必要な場合MCP は実際のツールを提供し、スキルはより良いデフォルト設定とレポート文を提供します
Jira skillチームが Linear ではなく Jira を使用している場合データモデルがまったく異なります

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る