スキルシステム

スキル（Skill）は Agent が使うための能力パッケージです。SKILL.md を中心とするディレクトリで、操作手順・スクリプト・参考資料が収められています。Agent はタスク実行時にこれらを必要に応じて読み込むことで、本来できなかったこと、たとえば目次とヘッダー付きの Word ドキュメントの生成などを行えるようになります。

スキルとは

各スキルは 1 つのディレクトリで、少なくとも 1 つの SKILL.md を含みます。frontmatter に name と description を記述し、本文は Agent 向けの操作手順です。ディレクトリには添付ファイル（スクリプト、参考ドキュメント、設定テンプレート）を含めることもでき、依存関係や MCP サーバーを宣言できます。

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

スキルは段階的開示を採用しています。Agent は普段は各スキルの名前と説明のみを参照し、現在のタスクで特定のスキルが役立つと判断したときに初めて本文と添付ファイル全体を読み込みます。これにより、多くのスキルをインストールしていても、すべての内容を毎回の対話に詰め込むことはありません。

システムスキルとユーザーインストールスキル

プラットフォームにプリインストールされている汎用システムスキルは主に 2 種類あります：Office ドキュメント生成（docx / xlsx / pptx / pdf）と開発系スキル（フロントエンド、フルスタック、iOS、Android、Flutter、React Native など）です。コンソールの「スキル管理」ページで一覧を確認でき、任意のスキルを開くとバージョン、添付ファイル、SKILL.md 全文を閲覧できます。

Office ドキュメント生成

このシステムスキル群により、Agent ステップは Markdown テキストだけでなく、オフィスドキュメントファイルを直接生成できます：

典型的な使い方：日報ワークフロー内の Agent ステップが xlsx スキルを使って書式付きの週報表を生成し、実行成果物とともにダウンロードするか、Slack / メールへ直接送達します。成果物は公開リンクとして公開することもできます。以下を参照してください：製品の公開共有。

スキルマーケット：インストールとバージョン

コンソールの「ClawHub スキルマーケット」ページは ClawHub レジストリに接続します。キーワードで検索し、各スキルのバージョン、作者、ダウンロード数、更新日時を確認でき、インストールをクリックすると自分のアカウントにインストールできます。

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• スキルはバージョン番号を持ちます。インストール済みのスキルは「スキル管理」ページで「更新を確認」をクリックすると、アップグレード時に最新バージョンを再ダウンロードします
• マーケットからインストールしたスキルのみアップグレードのフローに従います。ZIP でインポートしたスキルはアップグレード元がないため、再度インポートすれば十分です
• アンインストールは自分のアカウントのインストールを解除するだけで、同じスキルをインストールしている他のユーザーには影響しません
• ZIP を直接アップロードして自作のスキルをインポートすることもできます：パッケージ内には 1 つの SKILL.md が必要で、name と description フィールドが有効であること、また解凍後の合計サイズが 100MB を超えないことが条件です

ユーザー単位での有効化 / 無効化

「スキル管理」ページでは各スキルに独立したスイッチがあります。有効化 / 無効化の状態は自分のアカウントに記録されます。あるシステムスキルを無効化すると、それはあなたの Agent には表示されなくなりますが、他のユーザーには影響しません。他のユーザーがプライベートにインストールしたスキルは、あなたには表示されず、読み込まれることもありません。

Agent スコープ：特定の Agent が使えるスキルを制限する

アカウント単位のスイッチに加えて、Agent 設定で個々の Agent に対してより狭いスキル範囲を指定できます。よく使うフィールド：

• Skills サブシステムのスイッチ —— オフにするとこの Agent はスキルを一切使用しません
• ホワイトリストモード —— オンにするとホワイトリスト内のスキルのみがこの Agent に検出されます。組み込みスキルは自動的にホワイトリストに追加されます
• 無効化リスト —— ブラックリストで、ホワイトリストモードがオフの場合でも有効です
• リクエストごとの最大スキル数 —— 1 回のリクエストで注入されるスキルの数を制限します
• 自動検索ダウンロード —— デフォルトはオフです。オンにすると、Agent はローカルに能力が不足していると判断した際に自動で ClawHub を検索して新しいスキルをダウンロードします。外部ダウンロードの挙動が発生するため、企業環境では慎重に利用してください

実行時、プラットフォームは Agent 設定とあなたのユーザー単位の状態を統合し、最終的に有効なスキル範囲を決定します。「スキル管理」ページで無効化したスキルは、この実行内のすべての Agent で利用できません。

ランタイム設定

一部のスキルは、動作させる前にパラメータや認証情報を入力する必要があります。たとえばサードパーティサービスの API token などです。設定テンプレートを持つスキルはカード上に「設定済み / 未設定」と表示され、「Skill を設定」をクリックしてフィールドごとに入力します。

• 機密フィールド（token、パスワード、秘密鍵など）は保存後にマスク表示され、平文は再表示されません。マスクのまま送信すると、以前の値がそのまま使われます
• 自分でインストールしたスキルは自分で設定できます。システムスキルのランタイム設定は管理者のみが変更できます

よく使うエンドポイント

関連ページ

• エージェント構成の詳細説明
• 内蔵モジュールライブラリ
• 製品の公開共有