コンテンツにスキップ

Agent Skills 超入門：pre-builtとSKILL.mdの違いが3分でわかる

この記事の対象者

  • Claude CodeからAgent Skillsに入って混乱した人
  • 「pre-builtとSKILL.mdの違い」が分からない人
  • チーム導入の最小ユースケースを知りたい人

結論だけ先に言うと、pre-built skillsとSKILL.mdは別物です。この記事は「どっちが何で、いつ使うか」を3分で整理する地図です。

この記事のポイント

種別役割例位置づけ
pre-built skillsベンダーが用意した組み込み機能PowerPoint / Excel / Word / PDFClaude API側の機能拡張
SKILL.md（custom）自分たちの手順・判断基準を配るリリース手順 / 障害一次切り分けオープン標準のスキル形式

pre-builtは「道具」、SKILL.mdは「手順書パッケージ」と覚えると一発で整理できます。

30秒でわかる使い分け地図

どれを使う？（最短判断）

  • pptx/xlsx/docx/pdfを編集したい → pre-built skills（API側の機能）
  • チーム手順を標準化したい → SKILL.md（custom skill）
  • 常に守るルールがある → カスタム指示（always-on）

発動条件は「単語一致」ではない

Agent Skillsは、起動時にname/descriptionだけ読み込み、必要だと判断されたときにSKILL.md本文を読みます。なので「単語が入ったら必ず発動」という仕組みではありません。descriptionに「いつ使うか」を書くのが重要です。

最初の1本は「短く・固定」で作る

最初は難しいことをせず、短い手順＋固定の出力に寄せると効果が出やすいです。

  • 1スキル1目的（レビュー / 切り分け / チェックリスト）
  • 出力フォーマット固定（Summary / Risks / Next Actions）
  • descriptionに「いつ使うか」を含める

現場で効く最小ユースケース

1) リリース手順の標準化

  • Before: 毎回、手順を長文で貼る
  • After: 「release-checkでお願いします」で同じ手順を再現

2) 障害一次切り分け

  • Inputs: ログ、メトリクス、直前の変更
  • Output: 原因候補 / 影響範囲 / 次アクション

3) Terraform planレビュー

  • Before: 人によって観点がバラバラ
  • After: IAM・Network・破壊的変更を固定順で点検

最小のSKILL.md（8行）

最小構成（8行）
---
name: release-check
description: リリース前の確認を標準化する。deploy, release, rollback の話題で使う。
---
# 手順
1. 影響範囲の確認
2. ロールバック手順の確認
3. 監視指標の確認

よくある誤解

  • pre-built = SKILL.md？ → いいえ。pre-builtはAPI側の組み込み機能、SKILL.mdは自分で作る手順パッケージ。
  • Claudeが勝手にスキルを作る？ → 自動生成ではなく、依頼すればSKILL.mdを書いてくれる、という意味。
  • 人気・主流なの？ → 公式の利用統計は未公開。まずは小さく試すのが現実的。

次に読む

参考リンク