linear-claude-skill — インストール & ライブデモ

なぜ使うのか

主な機能

Linear のデータモデルを体系化: Teams → Projects → Cycles → Issues → SubIssues
よく使うレポート向けの GraphQL クエリスニペットを同梱
エージェントが一貫して適用する優先度・ステート・ラベルの規約
公式 Linear MCP と併用して書き込み操作に対応
Markdown のみのスキル — インストールが必要なランタイム依存なし

ライブデモ

実際の動作

linear-claude-skill.replay ▶ 準備完了

0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： linear-claude-skill

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

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

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

フロー

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 付き）
遅延を診断する

Which issues are still In Progress or In Review with 2 days left? Who owns them?✓ コピーしました

→ 課題ごとの一行サマリーとリスクの指摘
ロールオーバーを実行し、振り返りを作成する

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件溜まっていて、リストを整理する必要があるとき。

フロー

未トリアージのバグを一覧表示する

Find all issues in project 'Bugs' with no priority and no assignee, created in the last 14 days.✓ コピーしました

→ タイトル付きのランク付けテーブル
優先度と担当者を提案させる

For each, suggest priority (Urgent/High/Medium/Low) and the most-likely team based on the file paths or labels mentioned.✓ コピーしました

→ 一律 Medium ではなく、根拠のある提案
決定を適用する

Apply those priorities and assign to the suggested teams. Confirm before each write.✓ コピーしました

→ 課題ごとの確認

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

注意点

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

組み合わせ： github

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

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

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

フロー

プロジェクトの状況を収集する

Summarize project 'Mobile v2.0': issue counts by state, % complete, and what's changed since last Monday.✓ コピーしました

→ 数値スナップショットと差分
リスクを指摘させる

List the top 3 risks — issues blocked, overdue, or with no owner.✓ コピーしました

→ 理由付きのランク付けリスク一覧
アップデート文を下書きさせる

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)

課題、プロジェクト、サイクルには機密のロードマップ情報が含まれている場合があります。外部ツールに貼り付ける前に十分注意してください。

トラブルシューティング

よくあるエラーと対処法

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を見る