読み込みの段階が分かると、効かない原因を切り分けられる。
学習時間の目安: 45 分.
- 1見える名前と説明
- 2選択したSKILL.md
- 3必要な参照資料
- 4読み込みの証拠
独自の学習図。矢印は読み進める順序や判断の流れを表し、実測した実行traceではない。
前提となる章
根拠と演習の状態
本章は編集された学習ガイドです。出典を読んだこととSkillを実行して効果を測ったことを分けます。演習は未実施：not-run。実験ログやモデル出力はありません。
学習目標
- 段階的読み込みを説明できる
- 形式の互換性と実行の互換性を区別できる
仕事の役割
- 学習者：仮説と採点基準を決める
- AI：承認された範囲の読取りと成果物作成を補助する
- レビュー担当：成果とログを分けて確認する
入力
- この章で指定した入力例
- 確認する公式資料と版
三段階の読み込み
一般的な段階的開示では、最初に名前と説明から候補を発見し、選んだSkillの本文を読み、必要な資料を追加で開く。全Skillの全文を常時置く方式より、関係のない説明を増やしにくい。descriptionは紹介文であると同時に選択の手掛かりなので、「何ができるか」に加えて「どんな依頼で使うか」を書く。本文だけに起動条件を置くと、読まれる前の選択には役立たない。
選択の失敗と実行の失敗
正しいSkillがあるのに読まれない場合は、説明、配置、無効化設定、名前衝突、利用可能な読み取り手段を調べる。読まれたのに成果が悪い場合は、手順の曖昧さ、欠けた資料、相反する指示、ツール不足を調べる。最終文章に「Skillを使いました」と書いてあっても読み込みの証拠にはならない。取得ログ、呼び出しイベント、実際に読み込まれた版を確認する。確認できない場合は「起動不明」として測定から区別する。
ポータブルな形式とランタイム固有の機能
同じフォルダ形式を読めても、スクリプト実行、ネットワーク、サブエージェント、フック、承認UIの対応はクライアントごとに違う。仕様の任意項目やクライアント独自メタデータを、すべての環境で同じ効力があるものとして扱わない。とくにallowed-tools等の記載は、それだけでOSや組織の権限を増やす魔法ではない。実行環境の制約と確認方針が優先する。
Agent Skills client implementation
互換性の確認シート
移植時には、モデル名だけでなく、ホストアプリと版、Skillの置き場所、明示起動の方法、自動起動の有無、利用できるツール、依存パッケージ、参照パスを記録する。さらに長い会話で文脈が要約された後も指示が残るか、サブエージェントへ引き継がれるかを確かめる。動かない機能を削った版で評価する場合、その変更はSkillの別バージョンである。元のSkillの成績として発表しない。
制作・検証の工程
- 使うべき依頼を3件、似ているが使わない依頼を3件書く
- 手動で明示起動した条件と、自動選択に任せた条件を分ける
- 未起動・起動後失敗・環境不足を別のラベルで記録する
出力
- 6件のトリガー評価表
品質チェック
- 本文を読まれる前の説明を検査した
- 実行環境の機能を確認した
- 起動ログなしに成功と断定しない
失敗の切り分け
- 症状: 効果を観測していないのに成功と記録する
- 原因: 期待判定と実際の出力を混同した
- 対処: 未実施はnot-run、実測欄は空欄に戻し、原出力とログを取得してから採点する
演習: 起動テストを先に作る
上の工程を順に行い、上記の成果物を作ります。
完了条件: 同じキーワードを含む境界事例があり、起動と成果の評価が分離されている
Status: not-run.
出典が支える範囲
出典は本文やカタログの機能・配布元表示を支えます。実測効果や人気順位の根拠ではありません。確認日は公開資料を読んだ日で、公開日・更新日とは異なります。main 等の可変参照は厳密な実験用固定版ではありません。
MENTAL MODEL / 考える順序
発表から、自分の判断へ。
発表の主張と、論文・公式ドキュメントの条件を並べて読む。
出典
公開日は資料の日付、確認日は内容を参照した日です。コミュニティの観測は公式の確定事項と区別します。
01