Honeypot

Honeypot

AI エージェント向けの無料スキルインデックスです。機械可読で、登録は不要です。

公開先：https://honeypot-e6c.pages.dev

機械から取得する

インデックスは 1 つの JSON ファイルです。schema_version は "1" で、エントリーは .skills の下にあります。

# everything
curl -sL https://honeypot-e6c.pages.dev/api/skills.json | jq '.skills[] | .name'

# one category only (cheaper than filtering client-side)
curl -sL https://honeypot-e6c.pages.dev/api/by-category/trading.json | jq '.skills[] | .name'

# install one skill
curl -sL https://honeypot-e6c.pages.dev/api/skills.json \
  | jq -r '.skills[] | select(.name=="kalshi") | .install'
# then run the command it prints

リンクで共有できる検索

サイトでは URL パラメーターで同じフィルターを指定できるため、どの表示も共有またはブックマークできます。

• ?q= — 名前、説明、タグに基づく関連度順の一致（1 文字の誤字があっても一致し、該当箇所が強調表示されます）
• ?tag= — タグの完全一致
• ?category= — カテゴリーの完全一致

パラメーターは組み合わせられます。例：https://honeypot-e6c.pages.dev/?category=trading&tag=prediction-markets。 フィルタリングはブラウザー内で行われるため、この URL に対する curl の結果はフィルター適用前のページになります。 ページでは一致項目を順位付けし、1 文字の誤字も許容します。スクリプトで JSON に同じカテゴリーとタグのフィルターを適用し、さらに単純な部分文字列チェックを行うこともできます。

# substring stand-in for ?q= (the page ranks; this check does not)
curl -sL https://honeypot-e6c.pages.dev/api/skills.json | jq '.skills[]
  | select(.category=="data")
  | select(.tags | index("sports-data"))
  | select((.name+" "+.description+" "+(.tags|join(" "))) | ascii_downcase | contains("odds"))
  | .name'

各エントリーには、name、description、category、tags、last_verified（日付）、skill_md_url、install があります。新たに /api/changelog.json と /feed.xml（RSS）も追加されました。

編集者のおすすめは /api/editors-picks.json にあります。スコアはありません。スキルが scripts/gen.py の PICK_CRITERIA にあるすべてのチェック（説明の長さ、タグ、最近の検証、SKILL.md へのリンク）に合格すると、おすすめに選ばれます。このファイルにはチェックリスト自体が criteria と criteria_text として含まれており、サイトにはそのテキストがそのまま表示されます。

サイト上のすべてのカードに last_verified の日付が表示されます。STALE_AFTER_DAYS（180 日。scripts/gen.py で設定され、/api/editors-picks.json では stale_after_days として公開されています）以内に再検証されていないものには「古い」バッジが付き、おすすめから外れます。新しさは日付のみで判定し、スキルへの接続確認は行いません。 同じ JSON は https://raw.githubusercontent.com/oidsdev/honeypot/main/api/skills.json にもミラーされています。

スキルを提出する

1. SKILL.md としてスキルを作成します。skill-template.md をベースにしてください。
2. このリポジトリをフォークします。
3. skills/<your-skill>/SKILL.md に追加します。
4. リポジトリのルートからリンターを実行します。

python3 scripts/lint_skill.py skills/<your-skill>

pass は問題なしを意味します。fail は各問題について file:line: reason を出力します。問題には、name または description の欠落、説明が 20～300 文字の範囲外であること、禁止フレーズ（一覧は scripts/lint_skill.py にあります）、ファイルに解決できない相対リンクがあります。 5. プルリクエストを作成します。迅速にマージします。 6. リポジトリにバッジを追加します。

[![Indexed on Honeypot](https://honeypot-e6c.pages.dev/badge.svg)](https://honeypot-e6c.pages.dev)

スキルごとのバッジは /badge/<skill>.svg にあります。バッジ画像にはスキル名、バージョン、および scripts/gen.py のリンターに合格した場合にチェックマークが表示されます。

[![cron on Honeypot](https://honeypot-e6c.pages.dev/badge/cron.svg)](https://honeypot-e6c.pages.dev/skills/cron/)

バージョンは、SKILL.md のフロントマターで任意に指定できる version フィールドです。version を指定しない場合、バッジには last_verified が表示されます。チェックマークは、フロントマターに name と description があり、name がディレクトリ名と一致し、インデックスのエントリーにカテゴリー、タグ、last_verified の日付があることを示します。SVG は静的で、1 日間キャッシュされます。

要件（経験から学んだことです。これらを満たさないプルリクエストは差し戻されます）：

• フロントマターには name と description を含める必要があります。skills.sh などのディレクトリ CLI は、これらがないファイルを通知なくスキップします。
• category を 1 つ選び（trading、data、identity、meta、tooling、またはプルリクエストで新しいカテゴリーを提案）、tags と最新の last_verified 日付を追加します。これらは JSON インデックスに反映されます。
• MIT と互換性のあるライセンスのみ対象です。再配布できないものはインデックスに登録できません。
• スパム、重複、悪意のあるものはクローズします。掲載にはすべてプルリクエストでの審査が必要で、マージ前に内容を確認します。

ディレクトリ構成

• index.html — サイト
• ja/index.html — 日本語ホームページ
• search.js — サイトで使用するランキング付き検索（依存関係なし）
• categories/<name>/ — 最大規模の各カテゴリのランディングページ（生成されます）
• api/skills.json — 機械可読なインデックス
• scripts/gen.py — skills.json から派生するすべてのファイルを再生成します（変更のたびに実行してください）
• scripts/lint_skill.py — 提出されたスキルを検査します（フロントマター、説明の長さ、禁止フレーズ、相対リンク）
• scripts/lint-fixtures/ — リンターのテストに使用する5つのサンプルスキル（--fixtures）
• llms.txt — エージェント向けの説明
• skill-template.md — 空の SKILL.md テンプレート
• skills/<name>/SKILL.md — インデックス対象のスキル
• tests/test_search.js — node tests/test_search.js
• tests/test_gen.py — python3 -m pytest tests/test_gen.py
• tests/test_mcp_server.py — python3 tests/test_mcp_server.py
• badge/<name>.svg — スキルごとのバッジ。scripts/gen.py によって書き込まれます
• _headers — /badge/* のキャッシュヘッダー（1日）

ライセンス

MIT — Orbital Desk LLC。