shotfleet

shotfleet スキル

このリポジトリには、shotfleet 用のエージェントスキルと MCP サーバー設定が含まれています。shotfleet は macOS のコマンドラインツールで、アプリが提供するすべての言語について、1 つの英語の Maestro フロー（または独自の XCUITest スクリーンショットテスト。0.1.6 以降）から App Store と Google Play のスクリーンショットを撮影し、各スクリーンショットが正しい言語になっているかを確認します。

shotfleet 自体は有料のクローズドソースプログラムですが、無料枠があります。check は無料で、run は 2 言語まで無料です。ここにあるファイルは MIT ライセンスで、shotfleet のソースコードは含まれていません。AI コーディングエージェントに shotfleet の使い方を伝えるだけです。shotfleet 0.1.9 に対応しています。

このスキルを使うと、AI コーディングエージェントが shotfleet のインストール、セットアップ、実行、確認方法と、レポートの読み方を把握できます。

スキル	内容
shotfleet	メインのスキルです。実行するコマンド、終了コード、--json、フローの作成、トラブルシューティングについて説明します
shotfleet-review	確認レポートを修正リストに変換します（再撮影が必要な言語と、修正箇所がアプリかフローかを示します）
shotfleet-ci	GitHub Actions または別の CI に shotfleet check を追加します

スキルはエージェントに入力するコマンドを伝えます。Mac には shotfleet 自体も必要です。

curl -fsSL https://shotfleet.com/install.sh | sh

インストール

MCP サーバー

shotfleet をインストールした後：

claude mcp add shotfleet -- shotfleet mcp

その他の MCP クライアントでは、コマンドは shotfleet mcp（stdio）です。詳しくは、下記の MCP サーバーのセクションを参照してください。

Claude Code プラグイン

Claude Code のセッションで：

/plugin marketplace add noloman/shotfleet-skills
/plugin install shotfleet@shotfleet

または、シェルから：

claude plugin marketplace add noloman/shotfleet-skills
claude plugin install shotfleet@shotfleet

このプラグインには、3 つのスキルと shotfleet MCP サーバー（shotfleet mcp。check、run、doctor を利用できます）が含まれています。 MCP サーバーは shotfleet がインストールされている場合にのみ起動します。インストールされていない場合、/mcp では失敗として表示されますが、スキルは引き続き使えます。 すでに shotfleet skill install を実行している場合、スキルが重複して表示されます。片方を削除してください（~/.claude/skills/shotfleet*）。

GitHub Copilot、Codex、Cursor、Gemini CLI など（gh）

GitHub CLI 2.90 以降を使用する場合：

gh skill install noloman/shotfleet-skills --all --scope user

--agent でエージェントを選択します。例：--agent codex、--agent cursor、--agent gemini-cli、--agent claude-code。現在のプロジェクトにインストールするには、--scope user を省略してください。

任意のエージェント（npx）

npx skills add noloman/shotfleet-skills --skill '*' -g

Gemini CLI

gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-review
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-ci

shotfleet をすでにお持ちですか？

その場合、スキルもすでに利用できます。以下を実行すると、Claude Code、Codex、Cursor、Gemini CLI、Copilot が参照する場所にスキルをコピーします。

shotfleet skill install

上記のいずれかを実行した後、新しいエージェントセッションを開始し、「shotfleet で fastlane のスクリーンショットを確認して」のように依頼してください。

MCP サーバー

shotfleet mcp はローカルの stdio MCP サーバーを起動します。Mac に shotfleet がインストールされている必要があります。

ツール	内容
check	スクリーンショットのフォルダーを確認します。各画像に対応する言語が表示されているか、言語間で画像が重複していないか、欠けている画像がないか、ストアのサイズと枚数のルールに準拠しているかを確認し、簡潔な概要を返します
doctor	Maestro、Xcode、Android SDK が使用可能な状態か、何が不足しているかを示します。変更は加えません
run	shotfleet.toml の設定に従い、すべての言語でスクリーンショットを撮影してから確認します。シミュレーターとエミュレーターを起動するため、数分かかります

安全性：設定ファイル内のコマンドは、呼び出しに hooks: true が渡されない限り、MCP 経由で実行されません。これが指定されていない場合、run は [hooks] をスキップし、[capture] のビルド、[ios] simctl、または [android] shell を含む設定を拒否します。run は常に、設定ファイルで指定されたアプリをシミュレーターにインストールして実行するため、信頼できるプロジェクトのみを指定してください。check は読み取り専用ではありません。レポートフォルダーにレポート（check.json と index.html）を書き込みますが、スクリーンショットは変更しません。

価格

スキルは無料で、MIT ライセンスです。shotfleet では、check は無料で、run は 2 言語まで無料です。2 言語を超える run と export にはライセンスが必要です：shotfleet.com。

ライセンスキー

ライセンスキーをエージェントの設定、チャット、MCP の設定、リポジトリに貼り付けないでください。ご自身のターミナルで一度だけ、次のコマンドを実行してください。

shotfleet activate <your key>

以降、エージェントは shotfleet を使用し、キーを見ることはありません。CI では、キーを SHOTFLEET_KEY という名前のシークレットに設定してください。 claude mcp add --env でキーを渡さないでください。~/.claude.json に平文で保存されてしまいます。

ご質問

[email protected] までご連絡ください。ここにあるファイルは各リリース時に shotfleet のソースからコピーされています。詳しくは SYNC.md をご覧ください。