Repository avatar
AI Tools
v1.0.0
active

loadouts

com.setupbay/loadouts

Search and install ready-made setups (rules, skills, MCP configs) for AI coding agents.

Documentation

SetupBay

Ready-made setups for AI coding agents. Each loadout is a small bundle of the files an agent reads when it starts work: an AGENTS.md with the rules for one kind of project, adapters for CLAUDE.md and GEMINI.md, Cursor rules, skills, hooks and MCP configs where they help.

This repo holds the loadouts themselves. The website at setupbay.com has search, per-agent install steps, ready-made zips and the security notes for each one.

Works with Claude Code, Codex CLI, Cursor, Gemini CLI, Antigravity CLI and GitHub Copilot.

Using a loadout

Copy the files. Every folder under loadouts/ is one loadout. Copy what you need into your project root. A few things to know:

  • AGENTS.md goes in the project root. If you already have one, merge the two rather than overwriting yours.
  • CLAUDE.md and GEMINI.md just point Claude Code and Gemini CLI at AGENTS.md.
  • Skills live under skills/<name>/ here. Claude Code reads them from .claude/skills/<name>/, and most other agents from .agents/skills/<name>/.
  • listing.yaml describes the loadout: what each file is for, the tools it needs, what the security scan found, and the sources it draws on. You don't need to copy it.

If you'd rather not move files around by hand, each loadout's page on the site has a zip already laid out for your agent.

Use the MCP server. Add SetupBay to your agent as a remote MCP server and ask it to find and install a loadout for your project:

https://setupbay.com/mcp

For Claude Code, for example:

claude mcp add --transport http setupbay https://setupbay.com/mcp

The agent can search loadouts, read every file and get the install steps for itself. It should show you what it's about to write before it writes anything.

Claude Code plugins. Loadouts with skills or MCP servers are also available as plugins:

/plugin marketplace add https://setupbay.com/marketplace.json

Plugins can't carry project rules, so AGENTS.md and CLAUDE.md still come from the folder here or the loadout's page.

Suggesting a loadout

Got a setup that works well for you, or spotted something wrong in one of these? Send it through the submit page. Credit goes to whoever the ideas came from, and every loadout lists its sources in listing.yaml.

Loadouts

89 loadouts, grouped by what they're for.

Web apps

LoadoutWhat it does
Astro static siteAstro conventions for fast, zero-JS-by-default sites with content collections, plus a skill for deploying to Cloudflare Pages with headers and redirects. Page
Browser-verified UI changesMake the agent load every UI change in a real browser via Playwright MCP, exercise it, fail on console or network errors and attach screenshots at two widths. Page
Cloudflare Agents SDK, wired right before deployStateful agents on Workers with the agents package (SQL, state, schedules, @callable) and a check that every Agent class is bound, on SQLite, with nodejs_compat. Page
Cloudflare Workers rulesWorkers rules for agents: bindings from env, wrangler types, prepared D1 queries, waitUntil, secrets via wrangler secret, no deploys or --remote writes unasked. Page
Django 6 guard for removed APIs and django-upgradeStop agents writing url(), ugettext, is_ajax(), index_together and CheckConstraint(check=) into Django 6.1 projects, then run django-upgrade and Django's own checks. Page
Django app rulesDjango rules and a safe-migration skill: migrations checked in CI, two-step destructive changes, N+1 caught with query-count tests, settings from the environment. Page
Django REST Framework API rulesDRF rules for agents: explicit serializer fields, querysets scoped to the user, owner set on the server, pagination, and six tests for every endpoint. Page
Electron desktop app rulesElectron rules for agents: sandboxed renderers, narrow contextBridge APIs, sender-checked IPC, deny-by-default windows, CSP and fuses, with a static security check. Page
Electron end-to-end tests with PlaywrightPlaywright tests that drive the real Electron app: secure webPreferences, no Node in the renderer, IPC round trips, input validation and blocked navigation. Page
Expo and React Native with Expo MCPExpo rules for agents plus Expo's official MCP server: npx expo install, Expo Router, no secrets in EXPO_PUBLIC_, no production EAS releases, check on a simulator. Page
Expo EAS Update without shipping native changes over the airChecks whether an Expo change can ship as an EAS Update or needs a new build, using the native fingerprint; preview by CI, production rollouts by a person. Page
FastAPI guard against Pydantic v1 codeStop agents writing class Config, orm_mode, @validator, .dict() and pydantic.v1 into FastAPI apps on Pydantic v2, and catch Optional fields that became required. Page
FastAPI service rulesRules and an endpoint skill for FastAPI with uv and Pydantic v2: Annotated dependencies, typed responses, async only when awaited, lifespan, routes with tests. Page
FastAPI with async SQLAlchemy 2.1 and AlembicFastAPI on async SQLAlchemy 2.1: per-request AsyncSession, lazy="raise" with eager loads, async Alembic with alembic check, and tests that count queries. Page
Go service rulesGo rules for agents: wrapped errors with errors.Is, context first, owned goroutines, 1.22+ routing, timeouts, and gofmt, vet and go test -race as the gate. Page
iOS builds with MobileBuildMCP (XcodeBuildMCP)Let the agent build, test, run and screenshot iOS and macOS apps through MobileBuildMCP, pinned with telemetry off, with Swift concurrency and pbxproj rules. Page
Maestro end-to-end tests on EAS WorkflowsRun Maestro flows on EAS Workflows with fingerprint, get-build and repack, so pull requests skip native builds, plus a check of profiles, workers and flows. Page
Maestro UI flows for iOS and Android agentsMaestro MCP and CLI for coding agents: inspect the screen, try commands inline, save flows with ids and assertions, lint them, then run the smoke set. Page
Next.js + Supabase SaaSRules, an RLS audit skill and a read-only Supabase MCP config for vibe-coding a Next.js App Router SaaS without leaking your database. Page
Next.js 16 for agents: bundled docs and dev-server MCPAgents read the docs shipped with the installed Next.js, check code with the dev server's MCP tools, keep the managed AGENTS.md block intact and leave agent feedback off. Page
Page speed with Chrome DevTools MCP, measured not guessedChrome DevTools MCP pinned with a throwaway profile and telemetry off, plus a trace, fix, re-trace loop that compares medians with Core Web Vitals thresholds. Page
Playwright end-to-end tests agents don't make flakyRules for agents writing and healing Playwright tests, including Playwright's test agents: role locators, web-first assertions, no sleeps, never weaken a test to pass. Page
Rails app rulesRails 8 rules for agents: reversible migrations with real constraints, params.expect, N+1 checks with assert_queries_count, and rubocop and brakeman as the gate. Page
Rails request specs with RSpec and FactoryBotRSpec request specs for Rails 8.1 JSON endpoints: happy path, 422 errors, missing params, owner scoping and mass assignment, with FactoryBot and rubocop-rspec. Page
SQLAlchemy 2 guard against 1.x and legacy Query codeStop agents writing engine.execute, select([...]), row["name"] and session.query into SQLAlchemy 2 projects, and catch writes that are never committed. Page
Starlight docs on Astro 7 with checked linksAgent rules for Starlight 0.42 docs sites on Astro 7: front matter that search and llms.txt can use, links the validator checks, and the 0.39 sidebar change. Page
Supabase with a safe agentSupabase MCP scoped to one dev project, read-only, database and docs tools only; every change as a reviewed migration with RLS, policy and expand-contract rules. Page
SwiftUI with a Swift package core and swift test in CISwiftUI screens as thin views over @Observable view models in a Swift package, with Swift Testing tests run by swift test on Linux and macOS CI. Page
SwiftUI with Xcode's MCP tools (build, preview, test)Use Xcode 26.3+'s MCP server (xcrun mcpbridge) to build, read the log, render and look at SwiftUI previews, and run tests after every change. Page
Tauri 2 guard for Tauri 1 imports, config and Rust APIsStop agents writing @tauri-apps/api/tauri, appWindow, the allowlist, get_window and emit_all into Tauri 2 apps, and catch the snake_case invoke arguments Tauri 2 rejects. Page

Workflow

LoadoutWhat it does
AI code review rulesReview-only rule files for Claude Code Review, Cursor Bugbot and Copilot, built from one list: severity, a nit cap, what to skip and what to always check. Page
Claude Code hooks guard railsFail-closed PreToolUse, post-edit and Stop hooks that block force-pushes, .env reads and wild deletes, check each edit and run tests before done. Page
Definition of done for agents, with proofMake "done" mean the feature works, a test shows it, and no test was weakened, with a git-diff check for changed assertions, skips and deleted tests. Page
Guarded Ralph loopRun an agent in a Ralph-style loop with guard rails: a fresh process per pass, state in files, iteration and no-progress limits, and a check it cannot fake. Page
Handoff without compactionWrite HANDOFF.md before you clear context or switch agents: goal, decisions, exact failing test, next step, commit. A checker flags stale or incomplete handoffs. Page
Headless agents in CIRules and a GitHub Actions template for unattended claude -p or codex exec: bare mode, read-only, a spend cap, pinned versions, PR text as untrusted data. Page
Markdown docs with markdownlint and offline link checksAgent-written READMEs and docs checked offline: markdownlint-cli2, relative links and #anchors resolve, and every npm run command in the docs exists. Page
Overnight agent runs with budgets and a morning reportQueue coding tasks to run unattended, each with a finish-line check, its own worktree and branch, a dollar cap inside a nightly total, and safe retry settings. Page
Parallel agents in git worktreesRules and two skills for running several coding agents at once, one task per git worktree: isolation, ports, dependencies, rebasing and clean-up. Page
PR hygiene for agentsCommit and PR rules for coding agents: small PRs, a four-part body, screenshots with gh --attach and a leak check for session links and secrets before pushing. Page
Rust crate rulesRust rules for agents: typed errors instead of unwrap, clippy -D warnings, fmt and tests as the done-gate, no unsafe without a SAFETY note, no surprise MSRV bumps. Page
Second-opinion review from another modelBefore calling work done, the agent gets a read-only review of its diff from a different model, checks each finding and stops after two rounds. Page
Spec first, then ticketsLightweight spec-driven flow: a SPEC.md with testable acceptance criteria, small tickets, test-first builds in parallel waves and a review against the spec. Page
Vibe-coding guard railsA stack-agnostic working style for coding agents — plan first, small diffs, never delete tests to go green — plus handoff notes and up-to-date docs via MCP. Page
Writing rules that avoid AI-sounding proseRules and a linter that stop agents writing 'seamlessly empowers', 'not just X, it's Y', fake proof and em-dash runs into your docs, PRs and release notes. Page

Agent files and agents

LoadoutWhat it does
AGENTS.md examples for seven kinds of repositorySeven worked AGENTS.md examples (web app, Python library, monorepo, Go CLI, Godot game, OpenTofu) and a lint that checks commands exist, sizes, and CLAUDE.md shadowing. Page
Author plugins for Claude Code and AntigravityBuild one plugin for Claude Code and Antigravity from a single source tree, pin its MCP servers, and pass claude plugin validate --strict before anyone installs. Page
Cursor rules that loadHow to decide between AGENTS.md, Cursor .mdc rules, skills and hooks, write front matter that loads, and check that a rule is really attached. Page
Evals from real failuresBuild LLM and agent evals the practitioner way: read real traces first, tally failure categories, then turn each into code-checked regression cases. Page
MCP server (TypeScript)Rules and an add-a-tool skill for building a Model Context Protocol server in TypeScript that agents can actually use well — clear tools, safe inputs, no stdout noise. Page
MCP server in Go (official go-sdk)Build MCP servers in Go with the official go-sdk: typed tools with jsonschema tags, tool errors not panics, stdout kept for the protocol, in-memory client tests. Page
MCP server in Python (official SDK v2)Build MCP servers on the official Python SDK v2: MCPServer, Annotated schemas, structured output, ToolError for fixable failures and in-memory Client tests. Page
Migrate an MCP server to protocol 2026-07-28Move an MCP server to the stateless 2026-07-28 revision on the official SDKs: no sessions or handshake, server/discover, input_required, then a raw stdio probe. Page
One AGENTS.md for every agentKeep one AGENTS.md as the source of truth, with thin imports and a single MCP list, so Claude Code, Codex, Cursor, Copilot and Antigravity CLI all load the same rules. Page
One spend cap across Claude Code, Codex and AntigravityRun headless Claude Code, Codex and Antigravity CLI through one guard: a shared daily cap, per-run budgets, a ledger, and the provider limits that stop spend. Page
Skill descriptions that fit the listing and triggerKeep every SKILL.md description inside Claude Code's 1,536-character cap and both agents' listing budgets, with a trigger clause, so skills fire on their own. Page
Subagent model routingRules for when to delegate, which model and effort each subagent gets, and a brief template, with ready subagents for Claude Code and Codex. Page

Games

LoadoutWhat it does
Godot 4 game jamGDScript conventions, jam-scope discipline and a ship-to-itch.io skill so your agent helps you finish a Godot 4 game in 48 hours. Page
Godot 4 guard against Godot 3 codeStop agents writing yield, export var, KinematicBody2D and other Godot 3 code into Godot 4 projects, with a scanner that finds every case and Godot's own check. Page
Godot 4 headless GDScript testsA SceneTree test runner the agent runs with godot --headless after every change, failing on script errors with a non-zero exit, plus a linter for tests that can't fail. Page
Godot and Blender through MCPDrive Godot 4 and Blender from one agent: Godot MCP to run the game and read errors, MCP for Blender in safe mode to model assets, and a glTF pipeline between them. Page
Phaser 4 guard for Phaser 3 pipelines, FX and masksStop agents writing setPipeline, preFX, postFX, BitmapMask and setTintFill into Phaser 4 games, and catch the Math.TAU change that compiles but breaks rotations. Page
Phaser 4 web gamePhaser 4 rules that send the agent to the skills Phaser ships in node_modules, not v3 tutorials: pooled objects, delta movement, a play test after each change. Page
Roblox Luau (Rojo)Luau conventions for Rojo projects with a server-authoritative mindset, plus a skill that reviews every RemoteEvent for exploits before you publish. Page
Roblox pure Luau modules checked outside StudioKeep Roblox game rules in pure --!strict Luau modules that the luau CLI can type-check and test in milliseconds, with a scanner that keeps Roblox APIs out of them. Page
Unity 6 with the official agent pluginProject rules for using Unity's official agent plugin safely in Claude Code or Codex: commit first, Editor-driven scene edits, .meta discipline, compile and test checks. Page
Unity C# game jamUnity C# conventions that respect the editor, .meta files and serialisation, plus a skill for scripted web builds ready for itch.io. Page
Unity tests from the command line, read properlyRun Unity Test Framework Edit Mode and Play Mode tests headless and read the NUnit results, so a run of zero tests (Unity exits 0) never passes as green. Page

Security

LoadoutWhat it does
Audit agent hooks before you trust themHook security for Claude Code, Codex and Cursor: list every hook and settings command, flag guards that fail open, missing scripts, wrong exit codes and API redirects. Page
Cursor hooks that fail closed for shell, reads and MCPA Python guard for Cursor's permission hooks that blocks risky commands, secret reads and unlisted MCP servers, set to fail closed, with a config checker and self-test. Page
Dependency cooldowns and new-package checks for agentsRelease-age cooldowns for npm, pnpm, Bun and uv, plus a check agents run before adding any package: age, publishers, install scripts and look-alike names. Page
Don't start agents in DownloadsAfter the planted AGENTS.md attack: check what instruction and config files an agent will read in a folder, refuse drop zones, and treat setup steps as data. Page
GitHub Actions hardening for agent workflowsRules and a zizmor skill for agents editing GitHub Actions: SHA-pinned actions, permissions: {}, no template injection, no pull_request_target, read-only agent jobs. Page
OpenTofu modules gated by tofu test and CheckovAgents write OpenTofu modules that pass a local gate: fmt, a read-only lock file, tofu test with a mocked AWS provider, and Checkov with reasoned skips only. Page
Secure before you shipA launch-check skill and always-on security rules that catch leaked keys, open databases and missing auth before your vibe-coded app goes live. Page
Tauri 2 desktop app, least privilegeTauri 2 rules and a permissions skill: capabilities for named windows, scoped fs and http, no shell execute, a CSP kept, plus a checker that flags wide grants. Page
Terraform, plan onlyLet agents write Terraform and produce plans but never apply: a guard hook for apply, destroy and state changes, a plan summary that flags deletes, pinned providers. Page
Vet skills, plugins and MCP servers before installTreat agent skills, plugins and MCP servers as dependencies: pin by SHA or exact version, prove HEAD matches the pin, scan every file, and get a human yes. Page

Data

LoadoutWhat it does
Jupyter notebooks agents can editNotebook rules for agents: edit Jupytext-paired .py files instead of JSON, run top to bottom in a fresh kernel, keep outputs out of git with nbstripout, check data first. Page
Live Jupyter notebooks through Jupyter MCPAgents in a running JupyterLab via jupyter-mcp-server 2.2.4: loopback and a random token, saved cells over hidden kernel state, and a fresh-kernel rerun before done. Page
pandas 3 guard for copy-on-write and removed APIsStop agents writing applymap, fillna(method=), freq="H" and chained assignment into pandas 3 projects, where copy-on-write silently drops the write. Page
Polars 2 guard against Polars 1 codeStop agents writing melt, with_row_count, how="outer" and other names Polars 2 removed, and flag the calls whose results changed silently in 2.0. Page
Python data scriptRules for reproducible, single-file Python data scripts with uv and inline dependencies, plus a skill that sanity-checks a dataset before anyone trusts the numbers. Page

Bots

LoadoutWhat it does
Discord bot (TypeScript)discord.js v14 rules and an add-a-slash-command skill for building a Discord bot that registers commands properly and never leaks its token. Page
Discord bot in Python (discord.py 2)discord.py 2 rules for agents: slash commands in cogs, range-limited options, 3-second responses, manual syncing, default intents and offline tests of the payload. Page
Telegram bot with grammY on Cloudflare WorkersgrammY 1.46 webhook bots on Workers: secret-token check, botInfo, error boundaries instead of bot.catch, Queues for slow work, and tests with a fake Bot API. Page
Telegram bot with python-telegram-botRules and a command skill for Telegram bots on python-telegram-bot v22: token from the environment, async-safe handlers, testable logic, escaped output, webhook secrets. Page

Browser extensions

LoadoutWhat it does
Chrome extension (Manifest V3)Manifest V3 rules for service workers, messaging and minimal permissions, Playwright tests that load the extension in headless Chromium, and Chrome Web Store review prep. Page
Chrome MV3 service worker guard for MV2 codeStop agents writing MV2 background-page habits into MV3 extensions, such as globals as state and long timers, and prove state survives a service worker restart. Page

Licence

MIT. See LICENSE. Each loadout's sources are credited in its listing.yaml.

No installation packages available.

Remote