shotfleet MCP server

shotfleet skills

This repo is the agent skills and MCP server config for shotfleet, a macOS command-line tool that captures your App Store and Google Play screenshots in every language your app ships, from one English Maestro flow (or your own XCUITest screenshot tests, since 0.1.6), and checks that each screenshot is really in the right language.

shotfleet itself is a paid, closed-source program with a free tier: check is free, run is free for up to 2 languages. The files here are MIT licensed and contain no shotfleet source; they only tell your AI coding agent how to use it. They match shotfleet 0.1.9.

The skills let your AI coding agent know how to install, set up, run and check shotfleet, and how to read the report:

The skills tell your agent what to type. The agent still needs shotfleet itself on your Mac:

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

Install

MCP server

After installing shotfleet:

claude mcp add shotfleet -- shotfleet mcp

For any other MCP client, the command is shotfleet mcp (stdio). See the MCP server section below.

Claude Code plugin

In a Claude Code session:

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

Or from your shell:

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

The plugin brings the three skills and the shotfleet MCP server (shotfleet mcp, with check, run and doctor). The MCP server only starts if shotfleet is installed; without it, /mcp shows it as failed and the skills still work. If you already ran shotfleet skill install, you'll see the skills twice. Remove one copy (~/.claude/skills/shotfleet*).

GitHub Copilot, Codex, Cursor, Gemini CLI and others (gh)

With GitHub CLI 2.90 or newer:

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

Pick the agent with --agent, for example --agent codex, --agent cursor, --agent gemini-cli or --agent claude-code. Leave out --scope user to install into the current project instead.

Any agent (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

Already have shotfleet?

Then you already have the skills too. This copies them where Claude Code, Codex, Cursor, Gemini CLI and Copilot look:

shotfleet skill install

Start a new agent session after any of these, then ask something like "check my fastlane screenshots with shotfleet".

MCP server

shotfleet mcp runs a local stdio MCP server. It needs shotfleet installed on your Mac.

Shortened. The full README is on GitHub.