Communityライティング&編集github.com

エージェントスキル作成

AIエージェント用のスキルとSKILL.md命令パッケージを設計、起草、修正、または監査します。スキルのスコープ、トリガー説明、ワークフロー、関連する参照やスクリプト、安全境界、評価を作成または改善する際に使用します。スキルをホストエージェントと実際のタスクに合わせて調整します。

エージェントスキル作成 とは?

このスキルは、AIエージェント(例:Claude Code、Cursor、Codex)用の再利用可能な命令パッケージ(SKILL.md)を設計、起草、修正、監査するための包括的なガイドです。開発者がエージェントの振る舞いを特定のタスクに合わせて調整し、安全で効果的な実行を確保するのに役立ちます。スキルの目的は、一貫性があり実行可能な指示を提供することであり、計画や進捗報告のみに留まらないことです。主要機能には、トリガー条件とスコープの明確な定義、必須入力とオプション入力の指定、安全ゲートとデフォルトのヒューリスティックの区別、テストと反復による検証、そして最終的な配信物の整合性チェックが含まれます。このスキルは、YAMLフロントマター、マークダウン本文、参照ファイル、再利用可能なスクリプトを含む標準的なSKILL.md形式に従います。これにより、エージェントはあいまいさなくタスクを実行でき、ホストプラットフォームの機能を活用できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rafik-mikhail/write-agent-skill/tree/main

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エージェントスキル作成 は何をしますか?

目的

AIエージェントが実行可能な、一貫性のある再利用可能なジョブのための命令パッケージを提供します。ユーザーのタスク、例、ツール環境、既存の成果物、修正に基づいて作成します。実際の例がない場合は、仮定を明記し、製品固有のAPIをでっち上げるのではなく、最小限のテスト可能な指示を起草します。計画、進捗報告、批判だけでなく、実際に求められているスキルを完成させ提示します。

契約の定義

  1. トリガーを明記する: このスキルを起動すべきタスクと入力、および起動すべきでない類似のリクエストを記述します。descriptionは、何を実行し、いつ使用するかを指定する簡潔なルーティングルールとして記述します。
  2. 必須入力とオプション入力を明記する: エージェントの許可される権限、意図する出力、完了条件を定義します。隣接するスキルとの重複はハンドオフ時点で解決し、トピックが共通しているという理由だけで異なる段階を統合しないでください。
  3. 必須の安全/正確性ゲート、デフォルトのヒューリスティック、オプションの拡張機能を区別する: ランタイム権限を強制する方法として指示使用しないでください。ファイルシステム、ネットワーク、ツールアクセスにはプラットフォーム制御を使用します。

SKILL.mdの起草

YAMLフロントマターを使用し、nameはフォルダ名と一致する小文字のハイフン区切り、descriptionは具体的に記述します。ホストプラットフォームの形式と機能に従い、オプションのメタデータやallowed-toolsがプラットフォーム間でアクセスを強制することを想定しないでください。

本文は簡潔に保ちます:ジョブと境界、入力、決定手順、停止/失敗処理、出力契約、および非自明な落とし穴。同等の選択肢のメニューではなく、デフォルトのパスを示します。脆弱な操作には正確な手順を提供し、コンテキストの選択には正当な判断の余地を残します。同じ禁止事項をすべてのセクションで繰り返したり、単発のタスクの回答を一般手順として埋め込んだりしないでください。

大規模なドメイン参照は専用のreferences/ファイルに移動し、エージェントにいつ読むべきかを正確に指示します。反復的な決定論的作業には、ランタイム依存関係と検証動作を確認した後にのみ、再利用可能なスクリプトを追加します。参照はSKILL.mdから直接アクセス可能に保ち、ドラフトがインストール、実行、または検証されていないにもかかわらず、それらが行われたと主張しないでください。

テストと修正

2~3の代表的なケース(エッジケースを含む)から始め、スキルが信頼できないコンテンツに対して動作する場合や重要な境界がある場合は、ネガティブトリガーケースと敵対的ケースを追加します。スキルがある場合とない場合、または以前のドラフトに対して、新しいセッションを実行します。指示の洗練度ではなく、観測可能な出力とツールの動作を評価します。不必要なステップ、見逃された証拠、誤った起動、スコープの拡大についてトレースを検査します。機械的なチェックにはコードを使用し、実質的な判断は人間が検査します。実際の障害を防止せずにコストを追加するだけの指示は削除します。

納品チェック

応答する前に、要求された完全な成果物が実際に存在し、内部的に一貫していることを確認します。ユーザーが完全なMarkdownを要求した場合は、パッチの断片ではなく、現在のSKILL.md全体を提供します。ファイルを作成する場合は、ファイルが存在し、完全なドラフトが含まれていることを確認し、テストされていない状態を正直に報告します。何が変更されたか、および残っている検証の必要性を簡単に述べます。明確な要求なしに、1つのスキルの要求を無関係なスイートに変えないでください。

関連スキル