acquiring-skills

新しいスキルの取得

このスキルでは、Hermes Skills Hub、ClawHub（OpenClaw）、GitHub リポジトリ、Letta コミュニティリポジトリなど、外部ソースからスキルを安全に見つけてインストールする方法を説明します。

安全性 ― まずお読みください

スキルには次のものが含まれることがあります。

• Markdown ファイル（.md）— リスク：プロンプトインジェクション、誤解を招く指示
• スクリプト（Python、TypeScript、Bash）— リスク：悪意のあるコードの実行

信頼できるソース（ダウンロードにユーザーの承認は不要）

• https://github.com/letta-ai/skills — Letta のコミュニティスキル
• https://github.com/anthropics/skills — Anthropic の公式スキル
• official/* — Hermes の公式オプションスキル（NousResearch/hermes-agent から）

信頼できないソース（必ずユーザーに確認）

上記以外のソースの場合は、次の手順を必ず実行してください。

1. ダウンロードする前にユーザーに確認する
2. スキルの入手元を説明する
3. 明示的な承認を得る

ClawHub のコミュニティスキルや、任意の GitHub リポジトリもこれに含まれます。

スクリプトの安全性

信頼できるソースのスキルであっても、次の手順を必ず実行してください。

1. スクリプトを実行する前に読み、内容を確認する
2. スクリプトの動作を理解する
3. ネットワーク通信、ファイル操作、システムコマンドに注意する

ハーネス間の互換性

Hermes、OpenClaw など、ほかのエコシステム向けのスキルは、それぞれのハーネス向けに作成されています。インストール後は、使用する前に SKILL.md 全体を読み、次の点に注意してください。

• ハーネス固有のコマンド — 例：hermes skills config、openclaw plugins install、/curator、/kanban。これらは Letta では使えません。基盤となる機能を Letta のツール（Bash、Skill ツールなど）で実現できるか、あるいはそのスキルが単に適用できないのかを判断してください。
• ハーネス固有のパスと状態 — 例：~/.hermes/skills/、~/.openclaw/skills/、~/.hermes/config.yaml。Letta ではエージェントの memfs（<memory-dir>/skills/）にスキルを保存します。パスへの参照は適宜読み替えてください。
• ツールセットに関する前提 — Hermes の web ツールセットや OpenClaw の browser ツールなど、特定のツール名や API を前提とするスキルがあります。これらを同等の Letta ツールに対応付けるか、同等のものがない場合はその旨を記してください。
• プラットフォームの制限 — スキルのフロントマターに platforms: [cli, discord, telegram] と記載されていることがあります。Letta に該当しないプラットフォームの制限は無視してください。
• 環境変数 — スキルで API キーや認証情報が必要になる場合があります。フロントマターの requires.env を確認し、ユーザーが行う必要のある設定を記してください。

スキルのコア知識（手順、API リファレンス、ベストプラクティス）が役立つ一方、コマンドがハーネス固有の場合は、指示を読み替えて対応するか、該当する CLI ツールのインストールをユーザーに提案してください。スキルがハーネス固有の仕組みだけを扱い、応用できる知識がない場合は、そのスキルを使わずに代替手段を探してください。

このスキルを使用する場面

使用する場面

• スキルが存在しそうな依頼をユーザーから受けた場合（例：「この Web アプリのテストを手伝って」「PDF レポートを作成して」）
• 「理解を深めるのに役立つスキルがあるはず」と思った場合
• ユーザーが利用可能なスキルや機能の拡張について明示的に尋ねた場合

使用しない場面

• すでに対応できる一般的なコーディング作業
• 簡単なバグ修正や機能実装
• 十分な知識がある作業

検索前に確認する（対話モード）

スキルが関係しそうな作業だと判断した場合は、まずユーザーに確認してください。

「コミュニティスキルが役立ちそうな作業です。利用できるスキルを検索しましょうか？Hermes のカタログ、ClawHub、GitHub を確認できます。ご希望であれば、すぐにコーディングを始めることもできます。」

スキルを探すのを待たずに、すぐ作業を始めたいと考えるユーザーもいます。

ユーザーが同意した場合に限り、スキルの取得を進めてください。

スキルのソース

1. Hermes Skills Hub（NousResearch）

Hermes には、複数のレジストリにまたがる 88k 以上のスキルを備えた、充実した Skills Hub があります。プロジェクトに同梱される公式のオプションスキルに加え、skills.sh、著名なエンドポイント、GitHub リポジトリ、ClawHub、LobeHub、browse.sh のコミュニティスキルも含まれています。

Hermes スキルの検索：

Hermes CLI には、検索と閲覧の機能が組み込まれています。

hermes skills browse                              # Browse all hub skills (official first)
hermes skills browse --source official            # Browse only official optional skills
hermes skills search kubernetes                   # Search all sources
hermes skills search react --source skills-sh     # Search the skills.sh directory
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect openai/skills/k8s           # Preview before installing

ウェブカタログは https://hermes-agent.nousresearch.com/docs/skills にあります。

Hermes Hub のソース：

ソース	識別子の例	備考
official	official/security/1password	Hermes に同梱される公式のオプションスキル
skills-sh	skills-sh/vercel-labs/agent-skills/vercel-react-best-practices	skills.sh ディレクトリ
well-known	well-known:https://mintlify.com/docs/.well-known/skills/mintlify	/.well-known/skills/ でホストされるスキル
url	https://sharethis.chat/SKILL.md	単一の SKILL.md への直接 URL
github	openai/skills/k8s	GitHub リポジトリ／パス
clawhub	ClawHub registry skills	ClawHub マーケットプレイス
lobehub	LobeHub registry skills	LobeHub マーケットプレイス
browse-sh	browse-sh/airbnb.com/search-listings-ddgioa	browse.sh がクロールしたスキル

Hermes がインストールされていない場合は、公式のオプションスキルを直接閲覧できます。

# Browse the catalog on GitHub
# https://github.com/NousResearch/hermes-agent/tree/main/optional-skills
# Categories: autonomous-ai-agents, blockchain, creative, devops, finance,
#             health, mcp, mlops, productivity, research, security, ...

# Or clone and browse locally
git clone --depth 1 https://github.com/NousResearch/hermes-agent.git /tmp/hermes-browse
ls /tmp/hermes-browse/optional-skills/
ls /tmp/hermes-browse/optional-skills/finance/
rm -rf /tmp/hermes-browse

Letta への Hermes スキルのインストールには、official/ プレフィックスを使用します（公式のオプションスキルの場合）。

letta skills install official/finance/stocks
letta skills install official/blockchain/solana
letta skills install official/research/duckduckgo-search
letta skills install official/mlops/flash-attention
letta skills install official/creative/meme-generation

official/<category>/<skill> 形式では、NousResearch/hermes-agent をクローンし、optional-skills/<category>/<skill> からコピーします。

公式以外の Hermes Hub スキルを Letta にインストールするには、GitHub URL または省略形を使用します（例：letta skills install openai/skills/k8s）。

2. ClawHub（OpenClaw）

ClawHub（https://clawhub.ai）は、OpenClaw のスキルとプラグインを公開するレジストリです。バージョン管理、セキュリティスキャン、検索機能を備えた、コミュニティ提供のスキルをホストしています。

ClawHub スキルの検索：

# Browse the web registry
# https://clawhub.ai

# Or use the clawhub CLI if installed
clawhub search "calendar"
clawhub search "screenshot"
clawhub explore

# Or search via the API directly
curl -s "https://clawhub.ai/api/v1/skills?q=calendar" | jq '.items[].slug'

ClawHub スキルのインストールには、clawhub/ または clawhub: プレフィックスを使用します。

letta skills install clawhub/nano-banana-pro
letta skills install clawhub:nano-banana-pro
letta skills install clawhub:[email protected]      # pin a version
letta skills install https://clawhub.ai/skills/my-skill  # URL form also works

注： letta skills install nano-banana-pro のようにスラッグのみを指定しても、ClawHub からは解決されません。clawhub/ または clawhub: プレフィックスを必ず付けてください。

3. GitHub リポジトリ

SKILL.md を含む GitHub リポジトリは、どれでも直接インストールできます。

# Full repo (installs from repo root)
letta skills install https://github.com/owner/repo

# Subdirectory (tree URL)
letta skills install https://github.com/owner/repo/tree/main/path/to/skill

# SKILL.md blob URL (installs parent directory)
letta skills install https://github.com/owner/repo/blob/main/path/to/skill/SKILL.md

# Shorthand: owner/repo/path
letta skills install owner/repo/path/to/skill

4. Letta と Anthropic のコミュニティリポジトリ

リポジトリ	説明
https://github.com/letta-ai/skills	Letta エージェント向けのコミュニティスキル
https://github.com/anthropics/skills	Anthropic の公式 Agent Skills

これらは上記の GitHub URL 形式でインストールするか、手動でクローンしてコピーできます。

letta skills install コマンド

CLI は、スキルのダウンロード、エージェントのメモリーへの配置、変更のコミットを処理します。

letta skills install <source> --agent $AGENT_ID [--force]

環境内では、エージェント ID を常に $AGENT_ID で参照できます。自分の memfs にインストールするには、--agent で明示的に指定してください。

letta skills install official/finance/stocks --agent $AGENT_ID
letta skills install clawhub/nano-banana-pro --agent $AGENT_ID

フラグ	用途
--agent <id>	特定のエージェントの memfs にインストールします（自分のエージェントには $AGENT_ID を使用）
-n <name>	ID の代わりに名前でエージェントを解決します
--force	同名の既存スキルを置き換えます

トップレベルのエイリアス letta install <source> --agent $AGENT_ID も使用できます。

インストール済みスキルの管理：

letta skills list --agent $AGENT_ID
letta skills delete <skill-name> --agent $AGENT_ID

インストール先

letta skills install を使用すると、スキルはエージェントの memfs 内の <memory-dir>/skills/<skill-name>/ に配置されます。

手動でインストールする場合：

場所	パス	使用する場面
エージェント単位	~/.letta/agents/<agent-id>/memory/skills/<skill>/	1 つのエージェント向けのスキル（デフォルト）
グローバル	~/.letta/skills/<skill>/	複数のプロジェクトで役立つ汎用スキル
プロジェクト	.skills/<skill>/	プロジェクト固有のスキル

ルール： デフォルトではエージェント単位を使用します。リポジトリ固有のスキルにはプロジェクトを使用します。すべてのエージェントにスキルを継承させる場合にのみ、グローバルを使用してください。

手動ダウンロード（CLI でインストールできない場合）

スキルは、SKILL.md と、任意で scripts/、references/、examples/ を含むディレクトリです。

# Clone, copy, cleanup
git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/memory/skills/
rm -rf /tmp/skills-temp

新しいスキルの登録

インストール（CLI または手動コピー）後、次のメッセージからスキルが自動的に検出されます。スキルは ~/.letta/skills/、.skills/、およびエージェントスコープの ~/.letta/agents/<agent-id>/memory/skills/ ディレクトリから検出されます。

検索戦略

ユーザーの問題を解決するスキルを探す場合：

1. まず Hermes Skills Hub を検索します — hermes skills search <query> は、すべてのレジストリにある 88k 以上のスキルを検索します。Hermes CLI を利用できない場合は、GitHub で公式の optional-skills（finance、mlops、blockchain、devops、research、creative、security など）を参照してください。
2. ClawHub を検索します — バージョン管理に対応したコミュニティレジストリです。clawhub search またはウェブ UI を使用してください。
3. GitHub を検索します — SKILL.md ファイルを含むリポジトリを探してください。まず github.com/letta-ai/skills と github.com/anthropics/skills を試してください。
4. ユーザーに尋ねます — 特定のスキルリポジトリを知っていたり、ソースに希望があったりするかもしれません。

完全な例

ユーザーから「株価の追跡を手伝ってくれますか？」と尋ねられた場合：

1. 活用できる機会を見つける：株式／金融データ — Hermes には株価スキルがあります
2. ユーザーに尋ねる：「Hermes には、Yahoo 経由で株価、履歴、検索、暗号資産を扱う公式の株価スキルがあります。インストールしますか？」
3. ユーザーが同意したらインストールする：

   letta skills install official/finance/stocks --agent $AGENT_ID
   

4. 互換性を確認する：インストールした SKILL.md を読みます。調整が必要なハーネス固有のコマンド、パス、ツールがないか確認します（上記の「ハーネス間の互換性」を参照）。使用する前に、スキルの指示が Letta で問題なく使えることを確認してください。
5. 呼び出す：Skill(skill: "stocks")
6. 使用する：必要に応じてハーネス固有の詳細を調整しながら、スキルの指示に従います

ユーザーから「Nano Banana Pro で画像を生成できますか？」と尋ねられた場合：

1. 活用できる機会を見つける：ClawHub に画像生成スキルがあります
2. ユーザーに尋ねる：「ClawHub に nano-banana-pro スキルがあります。インストールしますか？」
3. インストールする：

   letta skills install clawhub/nano-banana-pro --agent $AGENT_ID
   

4. 互換性を確認する：SKILL.md を読み、OpenClaw 固有のコマンドやセットアップがないか確認し、必要に応じて調整します。
5. 呼び出す：Skill(skill: "nano-banana-pro")