独自スキルによる料理レシピアシスタントの作成
ここまでで基本のハーネスは動くようになりましたが、実運用では「特定のドメイン知識を持ったエージェント」を作りたい場面が出てきます。AgentCoreハーネスには、そうした知識・振る舞いをスキルという単位で外付けする仕組みが用意されており、コードを書かずに Markdown ファイル1枚でエージェントの役割・応答フォーマット・遵守ルールなどを宣言できます。
このセクションでは、独自スキルの作り方を体験するために、LambdaによるBedrockの応用操作を身につけよう で自前実装した料理レシピアシスタントと同じ役割を、独自スキルとしてハーネスに載せてみます。
1. 独自スキルとは
独自スキルは、SKILL.md という名前の Markdown ファイルにエージェントの役割・応答フォーマット・遵守してほしいルールなどを記述し、S3 バケットや Git リポジトリに置いてハーネスから読み込ませる仕組みです。
SKILL.md は AgentSkills.io 仕様 に沿った形式で、以下の要素を持ちます。
- 冒頭の YAML フロントマター(
nameとdescription)でスキルの識別情報を宣言する - 本文の Markdown に、エージェントに与えたい指示・応答フォーマット・ルールなどを記述する
- 必要に応じて、同ディレクトリに
scripts/(スクリプト)、references/(詳細ドキュメント)、assets/(画像などのアセット)を配置できる
スキルの配置先は自分で用意する必要があり、次のいずれかから選べます(詳細は Skills(AWS公式ドキュメント) に記載があります)。
- Amazon S3: S3バケットにディレクトリを作って
SKILL.mdを配置し、s3://bucket/prefix/の URI で指定する - Git (HTTPS): GitHub などのリポジトリを指定する(サブディレクトリ指定も可能)
- Filesystem path: ハーネスのコンテナイメージに焼き込んだり、セッション開始時にダウンロードして配置する
本章では、最もシンプルな S3 経由でスキルを配置します。
2. S3バケットとSKILL.mdの準備
料理レシピアシスタントとしての振る舞いを定義した SKILL.md を作成し、S3バケットにアップロードします。
2.1 S3バケットの作成
S3コンソールを開き、右上のバケットを作成をクリックします。「バケットを作成」画面が開くので、「一般的な設定」で以下の値を入力します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| AWSリージョン | アジアパシフィック (東京) ap-northeast-1 |
ハーネスと同じリージョンにする |
| バケットタイプ | 汎用(既定) |
一般的な用途で使うため既定のままにする |
| バケット名前空間 | グローバル名前空間(既定) |
既定のままにする |
| バケット名 | agentcore-harness-skills-<任意のプレフィックス> |
S3バケット名はグローバルで一意である必要があるため、<任意のプレフィックス>に自分だけが使う文字列(イニシャル・ランダム文字列など)を入れて重複しない名前にする |

その他の項目は既定のまま画面下部までスクロールし、右下のバケットを作成をクリックします。既定ではパブリックアクセスがすべてブロックされる設定になっており、ハーネスは実行ロール経由でバケットを読むため、パブリック公開の設定は変更不要です。

上部に「バケット agentcore-harness-skills-<任意のプレフィックス> が正常に作成されました」というバナーが表示されれば、バケット作成は完了です。

続いて、作成したバケットの直下に cooking-recipe-assistant フォルダを作成します。この後 SKILL.md をアップロードする置き場所になり、ハーネスにはこのフォルダを指定してスキルを読み込ませる形になります。
作成したバケットの詳細画面(オブジェクト一覧)で右上のフォルダの作成をクリックし、以下の値を入力します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| フォルダ名 | cooking-recipe-assistant |
ハーネスに登録するスキルディレクトリ名になる。この後の手順で S3 URI として指定するため、この名前に統一する |
| サーバー側の暗号化 | 暗号化キーを指定しない(既定) |
バケットの既定暗号化設定を継承させる |

入力できたら右下のフォルダの作成をクリックします。「フォルダ cooking-recipe-assistant が正常に作成されました」のバナーが表示され、オブジェクト一覧に cooking-recipe-assistant/ が並べば準備完了です。

2.2 SKILL.mdの準備
料理レシピアシスタントの SKILL.md を用意します。以下のファイルをダウンロードしてください。
ファイルの中身は、YAMLフロントマターと Markdown 本文の2ブロックで構成されています。
---
name: cooking-recipe-assistant
description: ユーザから料理名を受け取り、...
---
SKILL.md の冒頭にある --- で挟まれたブロックは YAML フロントマターと呼ばれ、スキル自体のメタデータを宣言する部分です。name はスキルの識別子、description はハーネスがスキルの用途を判断するための説明文で、実行時にモデルへ渡されます。
あなたは料理レシピアシスタントです。ユーザから料理名を受け取ったら、以下のフォーマットで必ず回答してください。
...
YAMLフロントマター以降の本文が、エージェントに与えられる指示です。応答フォーマット(推定時間・難易度・材料・手順・コツ)と、遵守してほしいルール(健康配慮・加熱手順・話題外の依頼への対応)を Markdown で自然文として記述しています。
2.3 S3へのアップロード
作成した cooking-recipe-assistant/ フォルダに SKILL.md をアップロードします。
S3コンソールで、先ほど作成した cooking-recipe-assistant/ フォルダをクリックして中に入り、右上のアップロードをクリックします。「アップロード」画面が開いたら、ファイルを追加からダウンロードしておいた SKILL.md を選択します。ファイルとフォルダの一覧に SKILL.md が並び、送信先が s3://agentcore-harness-skills-<任意のプレフィックス>/cooking-recipe-assistant/ になっていることを確認したら、右下のアップロードをクリックします。

「アップロードに成功しました」の緑色バナーが表示され、概要欄の成功しましたが 1 ファイル, 1.1 KB (100.00%) になっていればアップロード完了です。送信先 が s3://agentcore-harness-skills-<任意のプレフィックス>/cooking-recipe-assistant/ になっていること、ファイルとフォルダ一覧の SKILL.md のステータス列が 成功しました になっていることも確認します。

アップロード後、S3 URI が s3://agentcore-harness-skills-<任意のプレフィックス>/cooking-recipe-assistant/SKILL.md の形式になっていることを確認します。ハーネスに登録するのはファイル単位ではなくフォルダ単位なので、後のステップでは s3://agentcore-harness-skills-<任意のプレフィックス>/cooking-recipe-assistant/ の URI を使います。
3. 実行ロールへのS3読み取り権限の追加
ハーネスはクイック作成時に自動で払い出された実行ロール(AmazonBedrockAgentCoreHarnessDefaultServiceRole-XXXX)で動きます。この実行ロールはBedrockモデルの呼び出し権限しか持っていないため、S3からスキルファイルを読むための権限を追加する必要があります。
IAMコンソールを開き、ハーネス詳細画面に表示されていた実行ロール(AmazonBedrockAgentCoreHarnessDefaultServiceRole-XXXX)を選択します。許可タブで右上の許可を追加をクリックし、ドロップダウンからインラインポリシーを作成を選択します。

「アクセス許可を指定」画面が開きます。エディタ右上のJSONタブに切り替えて、以下のポリシー内容を貼り付けます。既存の内容がある場合は、丸ごと以下で置き換えてください。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::agentcore-harness-skills-<任意のプレフィックス>",
"arn:aws:s3:::agentcore-harness-skills-<任意のプレフィックス>/*"
]
}
]
}
s3:GetObject は SKILL.md などのファイル本体の取得に、s3:ListBucket はスキルディレクトリ内の一覧取得に必要です。両方を許可することで、ハーネスがスキルを問題なく読み込めるようになります。貼り付け後、画面右下の次へをクリックします。

「確認して作成」画面で、ポリシー名に以下を入力します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ポリシー名 | SkillsBucketReadPolicy |
用途が分かる名前を付ける。他のインラインポリシーとの識別のためスキル読み取り用と分かる名称にする |
このポリシーで定義されている許可の欄に S3 サービスが 制限あり: リスト, 読み取り のアクセスレベルで並んでいることを確認したら、右下のポリシーの作成をクリックします。

ロール詳細画面に戻り、緑色の「ポリシー SkillsBucketReadPolicy が作成されました。」バナーが表示され、許可ポリシー一覧に SkillsBucketReadPolicy が カスタマーインラインとして追加されていれば、権限追加は完了です。

4. MyHarnessへの独自スキルの追加
作成した独自スキルを MyHarness に登録します。MyHarness の詳細画面右上にある編集をクリックします。

編集画面を下方向にスクロールして、スキル – オプション (0) パネルにあるスキルを追加をクリックします。

「スキルを追加」モーダルが開きます。AWS スキル / Git / S3 / スキルパス (コンテナ内) の4種類のスキルソースが並んでいるので、S3 セクションのS3 を参照をクリックします。
「S3 リソースを選択」モーダルで、バケットルート(agentcore-harness-skills-<任意のプレフィックス>)まで戻り、cooking-recipe-assistant/ フォルダのラジオボタンを選択して、右下の選択をクリックします。

⚠️ SKILL.mdファイルを直接選ぶとNo files foundエラーが出る |
|---|
ここで cooking-recipe-assistant/ フォルダを選ばずに、フォルダを開いて中の SKILL.md ファイルを選ぶと、S3 URI の末尾に / が付いて .../SKILL.md/ という形になります。AgentCore はスキルディレクトリを指定する仕様(末尾スラッシュ付きのフォルダパス)を前提としているため、SKILL.md/ を「フォルダ」と解釈し、その中身を探しに行って No files found at S3 URI エラーで失敗します。必ずフォルダを選択してください。 |
「スキルを追加」モーダルに戻ります。S3 セクションの入力欄に s3://agentcore-harness-skills-<任意のプレフィックス>/cooking-recipe-assistant/ が入っていることを確認したら、右下の保存をクリックします。

編集画面に戻ります。スキル – オプション (1) パネルに、追加した S3 スキルの行が表示され、URL/パス列が s3://.../cooking-recipe-assistant/(末尾スラッシュ付きのフォルダパス)になっていれば、パネルへの追加は完了です。

このままではハーネス本体の設定はまだ保存されていません。画面下部までスクロールして、右下のハーネスを保存をクリックしてハーネスの設定を更新します。ハーネスの新しいバージョンが自動作成され、DEFAULT エンドポイントが最新バージョンに切り替わります。

5. 料理レシピの質問での挙動確認
スキルが有効になったハーネスに実際に質問を投げて、応答が期待どおりに変化することを確認します。
今のハーネスには、先に設定したシステムプロンプト(丁寧・箇条書き・一言まとめ)と、今回追加した料理レシピ Skill(description:料理レシピアシスタント/本文:推定時間・難易度・材料・手順・コツの5セクション形式)の2つの指示が同時に生きている状態です。この状態で料理クエリと非料理クエリの両方を投げて、それぞれがどう組み合わさって効くかを確かめます。
まず、料理系のクエリを投げます。
オムライスの作り方を教えてください
料理レシピなのでモデルは Skill を呼び出し、SKILL.md 本文がロードされます。応答上部の Agent trace に Skills のステップが表示され、SKILL.md がロードされたことが確認できます。応答本文は SKILL.md で定義したとおり、推定時間 / 難易度 / 必要な材料 / 手順 / コツ の5セクションで構成されて返ってきます。

次に、料理と関係ない話題を投げてみます。
日本一高い山は?
こちらのクエリでは、Skill の description によって「料理レシピアシスタント」というペルソナが与えられ、そのペルソナのままシステムプロンプトの指示(丁寧・箇条書き・一言まとめ)に沿った形式で丁重にお断りする応答が返ってきます。

料理クエリでは Skill 本文(SKILL.md)の詳細フォーマットが優先されて5セクション形式の応答になり、非料理クエリでは Skill 本文はロードされないためシステムプロンプトの形式(箇条書き + まとめ)で応答が返る、という綺麗な分担になっています。
コードを一切書かず、YAML と Markdown だけで独自エージェントの振る舞いを定義できるのが、AgentCoreハーネスとスキルの組み合わせの強みです。この章の最初にクイック作成した素のハーネスから、SKILL.md を1枚書いて登録するだけで、料理を尋ねると専門的な回答を返し、無関係な話題には丁重にお断りするハーネスに変身しました。
| 💡 ポイント |
|---|
Skill の description は常にシステムプロンプトに注入されて全クエリのペルソナに影響する一方、SKILL.md 本文はモデルが Skill を必要と判断したクエリのときだけロードされます(progressive disclosure)。エージェントの肩書き・守備範囲は description にコンパクトに書き、詳細な応答フォーマットや業務ルールは SKILL.md 本文に書く、という書き分けが自然な設計です。 |
6. 既製スキルという選択肢
独自スキルを自分で作る流れを体験しましたが、「よく使う領域のスキル」については、既製品を利用する選択肢もあります。今回は取り入れませんが、実務で役立つ場面もあるので選択肢として紹介します。
6.1 AWSスキル(AWS公式提供)
AWSスキル(AWS Skills)は、AWSサービスを扱うためのノウハウがあらかじめパッケージ化されたスキル群で、AWS Agent Toolkit(AWS公式GitHubリポジトリ) にラインナップされています。EC2・S3・Lambda・DynamoDB・CloudWatch などの基本操作から、Athena・Glue のような分析系、トラブルシューティング・診断まで揃っています。
「スキルを追加」モーダルのAWSスキルパネルには、以下の3つの選択肢が並んでいます。
無効にする(既定)すべての AWS スキルを有効にする特定の AWS スキルを有効にする(core-skills/aws-s3のようにグロブパターンで絞り込む)

| 💡 ポイント |
|---|
AWSスキルは AgentCoreランタイム内部にプリインストール済み(/opt/amazon/skills から読み込む)のため、S3や外部リポジトリを準備する必要も、実行ロールに追加の権限を付ける必要もありません。ラジオボタンで有効化するだけで動くのが、独自スキル(S3経由)との大きな違いです。 |
6.2 有志公開スキル(Git経由)
スキルは AgentSkills.io 仕様 というオープン標準に沿っているため、AWS 以外の第三者・有志も自由にスキルを作って公開できます。AWS公式ドキュメントでも例示されている Anthropic 公式のスキル集(GitHub) など、パブリックな Git リポジトリで公開されているスキルが多数あります。
「スキルを追加」モーダルのGitパネルには、リポジトリを指定するための入力欄が並んでいます。
Git URL: HTTPS 形式のリポジトリ URLサブディレクトリ – オプション: リポジトリ内で対象スキルを絞る場合の相対パス認証情報プロバイダー ARN – オプション: プライベートリポジトリの場合、AgentCore Identity で管理する Personal Access Token を指定するユーザー名 – オプション: Git 認証用のユーザー名

3種類のスキルソース(独自 S3・AWS公式・Git公開)はすべて併用でき、詳細は Skills(AWS公式ドキュメント) に記載があります。用途に応じて既製と独自を組み合わせて設計します。