Agent skill

skills-mcp-playbook

Skill/MCPの使い分けと組み合わせ設計を支援するガイド。外部ツール接続はMCP、手順・品質基準はSkillという分離原則、衝突回避、実例（財務バリュエーション/ミーティング準備）を参照し、どちらを使うか判断・設計したいときに使う。

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/yurake/skills/tree/main/product/skills-mcp-playbook

SKILL.md

Skills-MCP Playbook

使いどころ

  • 「Skillで書くか、MCPで実装するか」が曖昧なとき
  • 複数MCPを束ねてワークフロー化し、一貫した出力基準を持たせたいとき
  • MCPのI/O指示とSkill側のフォーマット指示が衝突しないようガードレールを敷きたいとき

判断クイックチャート（高レベル）

  • 何かにアクセス/操作する必要がある → MCP（接続とI/O契約）
  • どう進めるか、どの順で何を見てどう出力するかを共有したい → Skill（シーケンスと品質基準）
  • 両方必要 → MCPで取れるデータ/アクションを洗い出し、Skillで手順と合格基準を記述

設計ガイド（要点）

  • 分離原則: MCPは接続とフォーマット契約、Skillはワークフロー手順・優先順位・出力様式。
  • 衝突回避: 出力フォーマット指示はどちらか一方に寄せる。MCPがJSON返却要求ならSkillでMarkdown表を要求しない。Skillで整形するならMCPは「生データで返す」と明記。
  • 複数MCP束ね: Skill内で順序とフォールバックを決める（例: Notion→CRM→Web検索）。失敗時の代替手順も書く。
  • 品質基準: Skillに「完了条件」を書く（必須セクション、検証チェック）。
  • Progressive Disclosure: この記事の実例や使い分け表は references/ に分離、必要時のみ読む。

手順テンプレ（流用可）

  1. インテント整理: 目的と成果物の型（例: pre-read, agenda, valuationシート）
  2. MCP列挙: 必要な接続と取得/操作内容を箇条書き
  3. Skill記述: 取得順序、加工・検証手順、出力フォーマット、例外ハンドリング
  4. 衝突チェック: MCP側の返却形式とSkill側の期待形式を揃える
  5. 簡易テスト: ダミー入力で一連の流れと出力形を確認

参照

  • references/quick-diff-table.md: SkillとMCPの役割の対比表
  • references/examples/financial-valuation.md: 財務バリュエーションの組み合わせ例
  • references/examples/meeting-prep.md: Notionミーティング準備の組み合わせ例

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

yurake/skills

issue-create

GitHub Issue を作成する手順。依頼を受けたとき、.github/ISSUE_TEMPLATE の内容に応じてテンプレを選び、必須項目を埋めて GitHub MCP（issue_write/create）で Issue を作成する。

0 0
Explore
yurake/skills

ci-fail-followup

PR 作成後に .github/workflows/ci.yml が失敗したときの対応手順。ローカルで pytest 全ケースを実行し、エラー有無で分岐。エラーがあれば修正して commit-push スキルでコミット・プッシュ、無ければ GitHub Actions のログを確認して原因を特定する。

0 0
Explore
yurake/skills

review-rules

セッションの会話から恒久的な振る舞いルールを抽出し、AGENTS.md と突き合わせて追加すべきものを提示する。出力は rules と agents_md_patch の二部構成。

0 0
Explore
yurake/skills

pr-create

PR 作成手順を自動化するためのガイド。依頼を受けたとき、または 参照しているTODOファイル の「PR 作成」以外が完了したタイミングでタイトル・本文整形、テンプレ適用、MCP での PR 作成を行う。

0 0
Explore
yurake/skills

architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.

0 0
Explore
yurake/skills

test-risk-analyzer

あらゆる言語/スタックで潜在バグリスクを洗い出し、追加すべきテストケースを提案する。未テストのエッジケース探索や安全性確認、カバレッジ強化のテスト案提示を求められたときに使用する。

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results