Goodeye

goodeye

Goodeye は、AI が従うスキルと、その成果物が通過すべき検証ツールを保管するプライベートな場所です。

goodeye は Goodeye のコマンドラインインターフェースです。同じ機能は MCP サーバーと REST API 経由でもエージェントから利用できるため、エージェントが実行される場所を問わず動作します。この CLI は公開 /v1 REST API と通信します。

仕組み

スキルは、エージェントが従う Markdown の手順書です。検証ツールは、エージェントの出力が通過しなければならないチェックです。Goodeye はその両方を、あなたが所有する 1 つのアカウントで管理し、次の 3 つのことが実現します。

デフォルトでは非公開です。 テンプレートを公開するまでは、何も公開されません。これは、あなたが明示的に行う別の手順です。公開せずに共有するには、特定のユーザーまたはチームにアクセス権を付与します。スキルが参照する検証ツールも、同じバージョンで共有されます。アクセス権の取り消しも同様に行えます。

常に同期されています。 goodeye skills sync は、ホストされているスキルを、使用中のツールがすでに読み取っているディレクトリにミラーリングします。そのため、Claude Code、Codex、Cursor など、ディスクからスキルファイルを読み取るものはすべて、同じ最新バージョンを実行します。ターゲットを設定するだけで、自動同期が有効になります。それ以降はスキルを一度編集すれば、すべてのマシンに自動で反映されます。

検証ツールはホストされます。 検証ツールには、決定的なもの（形式、スキーマ、テスト、数値の範囲など）と、トーンや画像の品質など、テストでは判断できない内容を評価する LLM ジャッジがあります。セマンティック検証ツールを一度デプロイすれば、それを参照するすべてのスキルで、ノート PC、CI、またはアクセス権を付与した相手のマシン上で、まったく同じバージョンが実行されます。

全体像は https://goodeye.dev/docs/overview をご覧ください。

AI エージェントが主な呼び出し元です

CLI は、AI コーディングエージェントがあなたに代わって操作することを想定して設計されていますが、すべてのコマンドを自分で実行することもできます。想定される使い方は、エージェントに Goodeye のスキルを実行するよう依頼し、エージェントが goodeye skills get <name>（または goodeye templates get @handle/slug）で本文を取得して、それを表示したり要約したりせず、手順書として実行するという流れです。get コマンドはエージェント向けのマーカーで本文を囲み、呼び出し元のエージェントが実行すべき内容だと分かるようにします。生の内容が必要な場合は、--output PATH または --json を渡してください。

インストール

Python 3.12 以降が必要です。

uv tool install goodeye
# or: pipx install goodeye
# or: pip install goodeye

これで goodeye コマンドを PATH から実行できます。最新リリースにアップグレードするには goodeye update を、アップデートがあるか確認するには goodeye update --check を実行してください。

クイックスタート

すでにあるスキルを取り込む

ディスク上のスキルファイルは、SKILL.md と省略可能な関連ファイルを含むディレクトリです。これは publish が想定する形式そのものです。インポートは 1 つのコマンドで行えます。

goodeye login                                     # or: goodeye register (same browser sign-in)
goodeye skills publish ~/.claude/skills/my-skill  # also ~/.agents/skills, ~/.cursor/skills, or any path
goodeye skills list

インポートされたスキルは、非公開のホスト型スキルとして保存されます。テンプレートを公開するまでは、何も公開されません。これは別の手順です。

すべてのマシンとエージェントに同期する

Goodeye にツールが読み取るディレクトリを指定してから、取得します。

goodeye skills sync target add --preset claude    # ~/.claude/skills
goodeye skills sync target add --preset agents    # ~/.agents/skills
goodeye skills sync target add --preset cursor    # ~/.cursor/skills
goodeye skills sync

ほかのマシンでも同じコマンドを実行すれば、すべてのマシンで最新バージョンを読み取れます。ターゲットを設定すると自動同期が有効になるため、追加のコマンドを実行しなくても同期が続きます。新規および更新されたスキルだけを取得し、ローカルの編集内容は上書きしません。競合があった場合は、上書きするのではなく報告します。goodeye skills sync auto off で無効にすると、その状態が維持されます。

今公開したスキルは、ターゲットに設定済みのディレクトリから作成されているため、そのコピーはすでにそこにあります。Goodeye がそのコピーを書き込んだわけではないため、最初の取得では変更済みとして報告され、変更されずに残ります。公開したバージョンがホスト上のバージョンです。goodeye skills sync pull --force <slug> を一度実行してこれを採用すれば、以後はほかのスキルと同様に追跡されます。

共有する

goodeye skills grant my-skill @teammate view
goodeye skills grants my-skill

相手のエージェントはあなたのスキルを実行できるようになり、スキルが参照するセマンティック検証ツールも、同じバージョンのまま付与されます。スキルを改善すると、相手は次回のプルで改善版を取得できます。

ゼロからスキルを作成する

goodeye design                         # prints the designer prompt; pipe it to your agent to draft a skill and its verifiers

# save the draft from your agent's output (stdin keeps a stray file out of the working directory):
goodeye skills publish - \
  --name my-skill \
  --description "One sentence on what this does and when to use it." <<'EOF'
# Body

The skill body your agent will execute.
EOF

goodeye skills get my-skill            # fetch it back for an agent to run

アカウント不要で公開テンプレートを実行する

公開テンプレートの閲覧、取得、実行にサインインは不要です。

goodeye templates list
goodeye templates get @goodeye/high-signal-chart-workflow

templates get はテンプレートの本文（スキル）を出力し、エージェントはその指示に従います。データセットを見つけ、チャートを描画し、テンプレートに固定された検証ツールを実行して、チャートが合格するまで修正します。この検証ツールの実行は、ネットワークごとに少量のクレジットが付与されているエージェントが行うステップです。

# what your agent runs against the finished chart:
goodeye verifiers run 89dcc843-d056-44d9-ae34-ebcff4903885 \
  --version 1 --media-url '<public-https-chart-url>' --anonymous

goodeye templates fork @goodeye/high-signal-chart-workflow を実行して、自分のスキルとしてフォークします。フォークは自分のレジストリに保存されるため、ここでアカウントが必要なのはこのステップだけです。自分のテンプレートを公開するには、まず goodeye me claim-handle your-handle でハンドルを取得し、次に goodeye templates publish my-skill を実行します。

CLI でできること

以下のコマンド領域で、すべての機能を利用できます。正確なコマンドとフラグは goodeye --help または goodeye <area> --help を実行して確認してください。詳細なリファレンスは https://goodeye.dev/docs/cli をご覧ください。

領域	機能	ドキュメント
skills	非公開スキルの検索、保存、バージョン管理、実行、共有、改善を行います。指導、最適化、監査、ローカルファイルとの同期も含まれます	https://goodeye.dev/docs/skills
templates	公開カタログの閲覧、スキルのテンプレートとしての公開、カスタマイズ用のフォークを行います	https://goodeye.dev/docs/templates
verifiers	スキルが呼び出してエージェントの出力を評価する、LLM による判定チェックをデプロイして実行します	https://goodeye.dev/docs/verifiers
image-generators	再利用可能な画像ジェネレーターをデプロイし、スキルから呼び出せる画像を生成します	https://goodeye.dev/docs/image-generators
images	安定した URL でホストされた画像をアップロード、管理します	https://goodeye.dev/docs/images
teams	チームを作成し、メンバーシップを管理して、スキルをグループと共有できるようにします	https://goodeye.dev/docs/teams
referrals	紹介コードを表示し、他の人のコードを利用します	https://goodeye.dev/docs/referrals
invitations	チームへの招待や所有権移転の招待を承諾、辞退、キャンセルします	https://goodeye.dev/docs/cli
billing	Pro へのアップグレードまたは解約（plan upgrade ／ plan cancel）、請求ポータルの表示、クレジットの一回限りの追加購入、自動追加（auto-topup show ／ set ／ off）の管理を行います	https://goodeye.dev/docs/cli
auth, me, usage	API キーの管理、ハンドルの取得、クレジット使用量の確認を行います	https://goodeye.dev/docs/cli
design	エージェント用のスキル設計プロンプトを出力します	https://goodeye.dev/docs/cli

セッションコマンドはトップレベルにあります：login、register、logout、whoami、update。

認証と設定

goodeye login または goodeye register で対話形式のサインインを行います。どちらもブラウザーでデバイスコードフローを開始し、成功すると認証情報を保存します。ブラウザーを使わないエージェントや自動化では、メールコードフローを使用します。

goodeye register --email [email protected]
goodeye register-verify --email [email protected] --code 123456
# existing account: goodeye login, then goodeye login-verify

goodeye whoami で自分の情報を確認し、goodeye logout でローカルの認証情報を削除できます。エージェントやスクリプトは、代わりに API キーで認証できます。goodeye auth create-key --name my-agent でキーを作成し、GOODEYE_API_KEY 環境変数として渡してください。

CLI は最初に GOODEYE_API_KEY から認証情報を読み込み、次に ~/.config/goodeye/credentials.json から読み込みます（ファイルは 0600 のアクセス許可で作成されます）。デフォルトでは https://api.goodeye.dev を使用します。GOODEYE_SERVER で変更できます。認証の詳細は https://goodeye.dev/docs/cli をご覧ください。

CLI、MCP、または REST

CLI は公開 /v1 REST API の便利なラッパーです。安定したプログラム用インターフェースを利用するには、その REST API を直接呼び出してください（https://goodeye.dev/docs/rest-api）。MCP クライアントから Goodeye を操作するには、mcp.goodeye.dev/mcp に接続してください（https://goodeye.dev/docs/mcp）。どのインターフェースを利用しても、スキルと検証ツールをエージェントに届けられます。

ドキュメント

• 概要と基本的な考え方：https://goodeye.dev/docs/overview
• はじめに：https://goodeye.dev/docs/getting-started
• CLI リファレンス（すべてのコマンドとフラグ）：https://goodeye.dev/docs/cli
• スキル：https://goodeye.dev/docs/skills
• 検証ツール：https://goodeye.dev/docs/verifiers
• テンプレート：https://goodeye.dev/docs/templates
• 公開テンプレートカタログ：https://goodeye.dev

貢献

ローカル開発環境のセットアップとプルリクエストの手順については、CONTRIBUTING.mdをご覧ください。Issue とプルリクエストを歓迎します。

ライセンス

MIT。LICENSEをご覧ください。