スキル

スキルは、標準的なやり取りなしに特定のタスクを完了するために設計された、繰り返し可能なステップバイステップのプロセスです。

エージェント A は、タスクがスキルの説明と一致する場合にオンデマンドでそれを読み、含まれている指示に従います。

プレビューをクリックして、実際の指示、必要な入力、およびサンプル出力の例を確認してください。

事前構築されたスキル（Ahrefs によってキュレーション）

Agent A は、Ahrefs チームによって定期的に保守・更新される、成長し続けるスキルライブラリを備えています。これらを通じて、Agent A はすぐに世界レベルのマーケターのように実行できます。

ワークスペーススキル（あなたのスキル）

~/workspace/skills/<skill-name>/SKILL.md にある独自のワークスペース内に、スキルの第 2 層が存在します。これらはチーム、製品、声、ワークフローに固有のルールです。これらを作成、編集、キュレーションします。

チャットで full skill ファイルをインラインで編集するよう依頼することもできます。

新しいスキルを追加する方法

質問の形式：

"<rules>をキャプチャする<name>というスキルを作成します。トリガーの説明は<one-line>にしてください。参考例：<paste or attach>"

エージェント A:

ルールを含む SKILL.md を下書きし、簡単に取得できるように構造化します。
~/workspace/skills/<name>/ に配置します。
代表的な質問を自分自身に尋ねることでテストし、スキル実行中に読み取ります。

スキルを更新する方法

ファイルを直接編集するか、「ブランドボイススキルを更新：em ダッシュを使用しないというルールを追加してください」と指示します。エージェントはその場で追加または修正します。次のチャットで自動的に変更が反映されます。

スキルの構造方法

~/workspace/skills/<skill-name>/
  SKILL.md            ← required; description in frontmatter, body is the playbook
  reference.md        ← optional supporting docs
  examples/...        ← optional examples
  assets/...          ← optional images, templates, CSS

SKILL.md フロントマターは以下のようになっています：

---
name: ahrefs-brand-voice
description: Voice rules and review checklist for any Ahrefs copy. Load when writing or reviewing copy for landing pages, emails, ads, video scripts, or briefs.
---

description はエージェントがマッチングする対象です。曖昧な場合、スキルは必要な時にトリガーされません。正確な場合、関連する時に正確にアクティベートされます。

エージェントがスキルを使用する場合

チャット開始時に、エージェントは利用可能なスキル（プリセットとワークスペース両方）とその説明のリストを表示します。リクエストが一致する場合、作業を行う前に本文を読みます。

ランディングページを作成 → ahrefs-brand-voice と ahrefs-design-manual を読み込み。
PDF を生成 → PDF を読み込み（必須；サンドボックスは一般的なライブラリをブロック）。
サードパーティ API を呼び出し → connectors を読み込み。
LLM を呼び出す Console ページを作成 → llm と pydantic を読み込み。

ブランドボイススキルを使用してから回答する」というスキルを強制的に読み込むこともできます。

内部動作。 スキルは魔法ではありません。説明の一致に基づいてエージェントが読むことを決定するマークダウンです。コストは読み込みであり、利点は一貫性です。事前構築されたスキルはプラットフォームの読み取り専用ストアから提供されます。ワークスペーススキルはワークスペースに存在し、進化させるのはあなた次第です。ルールが 1 つのチャットにのみ適用される必要がある場合は、チャットで述べてください。今後のすべてのチャットに適用される必要がある場合は、スキルまたはメモリに入れてください。