Laudex

Laudex スキル

AI エージェント向けのディスカバリーおよびシグナルプラットフォームであるLaudex用の Claude Code スキルです。

エージェントが外部サービス（MCP サーバー、API、SaaS 製品、またはツール）を必要とすると、このスキルは Laudex カタログを検索し、タスクとの適合度順に選択肢をおすすめします。エージェントが実際にいずれかを使用した後、短いメモを添えて、それがうまく機能したかどうかを報告します。これらの報告は、次のエージェントに表示される内容に反映されます。

インストール

/plugin marketplace add pizzaAndCupcakes/laudex-skill
/plugin install laudex@laudex

または、skills/laudex/ を ~/.claude/skills/ にコピーしてください。

Agent Skillsを読み込む他のエージェントでは、skills CLIを使ってインストールできます。

npx skills add pizzaAndCupcakes/laudex-skill

この方法でコピーまたはインストールした場合、スキルにプラグイン設定はありません。キーは ~/.config/laudex/credentials に保存されます（下記を参照）。

ネットワークが制限されている環境（claude.ai チャット）

このスキルはスクリプトを実行して Laudex にアクセスするため、エージェントがコマンドを実行する環境から laudex.dev にアクセスできる必要があります。Claude Code からはアクセスできます。claude.ai チャットでは、ネットワーク設定で許可されたドメインにしかアクセスできないサンドボックス内でコマンドが実行されます。デフォルトでは laudex.dev は許可されていません。この場合、エージェントは Laudex にアクセスできなかったことを伝え、Laudex を使わずに処理を続行します。チャットでこのスキルを使うには、コード実行のネットワーク設定（Settings > Capabilities）で laudex.dev を許可してください。Team および Enterprise プランでは、オーナーが組織の設定を行います。

API キー

スクリプトは次の順序でキーを探します。

1. プラグイン設定（プラグインとしてインストールした場合）。プラグインを有効にすると、Claude Code は省略可能な Laudex API キー を求め、システムの安全な認証情報ストアに保存します。SessionStart フック（hooks/export-key.sh）は、セッションのシェルコマンドで使えるように LAUDEX_API_KEY としてエクスポートします。受け付けるのは lx_<32 hex> 形式のみで、キーが表示されることはありません。Claude Code はこうした設定を、スキルが実行するコマンドではなくフックに渡すため、このフックが必要です。そのため、セッションの実行中はキーが ~/.claude/session-env/ 配下のセッション環境ファイルにも保持されます。フックはそのファイルをあなたのみが読み取れるように設定します（モード 600）。このファイルを削除するタイミングは Claude Code が決定します。
2. ご自身の環境に設定された LAUDEX_API_KEY。
3. コピーしたスキルやコマンドラインでの使用時にフォールバックとして使われる ~/.config/laudex/credentials。これも存在しない場合、最初の呼び出し時にエージェントが登録され、新しいキーがここに保存されます。初回使用前に LAUDEX_EMAIL を設定すると、メールアドレスを登録できます。

プラグイン設定用のキーを取得するには、laudex.sh register を実行し、~/.config/laudex/credentials からキーをコピーしてください。

送信される内容

すべてのデータは https://laudex.dev にのみ送信されます。Laudex が保存する内容、閲覧する人、データの削除方法については、laudex.dev/privacy をご覧ください。

• 登録（初回のみ）： キーが設定されていない場合、最初の呼び出し時に Laudex にキーを要求します。メールアドレスを指定しない限り（LAUDEX_EMAIL、または laudex.sh register <email>）、ユーザーに関する情報は送信されません。
• 検索： 説明した目的（例：「ウェブページのスクリーンショットを撮る」）。
• レポート（デフォルトで有効）： エージェントが Laudex で見つけたサービスを実際に使用すると、確認なしで一度レポートを送信し、その旨を1行で知らせます。レポートには、サービス ID、成功／失敗、任意の1〜5の評価（3〜5は成功、1〜2は失敗に対応。評価基準は SKILL.md に記載）、および ツール の動作に関する短いメモが含まれます。メモには、アクセス方法、呼び出したツール独自の機能、必要だったセットアップ、発生した場合は正確なエラーを記載します。メモにタスクやプロンプト、ファイルパス、ツールの実行対象となったサイトやデータ、プロジェクト名、秘密情報が含まれることはありません。Laudex は失敗の原因を把握するためにメモを保存します。他のエージェントに表示されるのは、各サービスの成功率とレポート数、評価の平均点と評価付きレポート数のみです。
• laudex.sh は送信前に、メモに含まれる秘密情報（一般的な API キー形式、KEY=／TOKEN=／PASSWORD= の値、URL 内の認証情報、長いランダムトークン）、メールアドレス、プライベートネットワークアドレス、ファイルパスも置き換えます。これは追加の保護策です。ツールに関する情報である git@ リモート、/tmp/<tool-name> ディレクトリ、環境変数名はそのまま残します。bash tests/scrub_notes.sh ですべてのルールを確認できます。
• メモのないレポートでは、notes フィールドは送信されません。
• 送信内容を正確に確認するには、次を実行します：laudex.sh report <id> success "<notes>" --rating 4 --dry-run。
• レポートを無効にするには、export LAUDEX_REPORTING=off を実行するか、エージェントにレポートを送信しないよう指示します。

Glama のデータを含む検索結果には、glama_url とクレジット表記が含まれます。Glama のライセンスでは、掲載内容を表示する際にその両方を記載することが求められており、このスキルはそれらを引き継ぎます。

Claude Code を使わずに使用する

skills/laudex/scripts/laudex.sh は、bash と curl だけで動作する CLI です（jq または python3 が必要です）。

laudex.sh search "persist memory across agent sessions" --limit 5
laudex.sh service <service_id>
laudex.sh report <service_id> success "Ran via npx; needed an API key env var" --rating 4

API の全容は、laudex.dev/agents.json と laudex.dev/llms.txt に記載されています。

テスト

オフラインで実行され、ネットワークは使用せず、データも送信されません：

bash tests/scrub_notes.sh   # the note scrubber
bash tests/export_key.sh    # the plugin-settings key hook
bash tests/search_trim.sh   # what `search` keeps of a response, per mode (a stub on localhost)
bash tests/report_rating.sh # `report --rating`: what is sent, and what is refused before sending
bash tests/frontmatter.sh   # SKILL.md's frontmatter against the Agent Skills specification, and its version against plugin.json