{
  "id": "agents-md-examples",
  "type": "loadout",
  "title": "AGENTS.md examples for seven kinds of repository",
  "summary": "Seven 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.",
  "description": "Most AGENTS.md files are either one vague line or a 500-line wall, and both get ignored. The ones that work share a shape: one line on what the project is, exact commands (including how to run a single test), the layout, conventions and a Never list, and what done means. This loadout gives seven worked examples in that shape. They cover a Next.js app, a published Python library, a monorepo root with a nested app file, a Go CLI with golden files, a Godot 4 game and an OpenTofu repo that agents may only plan.\n\nThe skill tells the agent to fill the file from the repository's real scripts and to run every command before writing it down. Then a standard-library lint checks it against what agents load. It errors when the chain from root to folder passes Codex's 32 KiB limit, when a CLAUDE.md beside the file doesn't import it (so Claude Code ignores it), and when an npm, pnpm, make or just command doesn't exist. It warns on a missing test command, a missing Never list, files over 150 lines and paths that aren't there, and it prints which files Codex joins for each folder.\n",
  "highlights": [
    "Seven 30–40 line examples, from web app to OpenTofu, in one five-part shape",
    "Lint checks every npm/pnpm/make/just command exists before an agent runs it",
    "Catches a CLAUDE.md that shadows AGENTS.md for Claude Code",
    "Codex's 32 KiB project_doc_max_bytes checked across nested files",
    "Shows which AGENTS.md files Codex joins for each folder"
  ],
  "version": "1.0.0",
  "license": "MIT",
  "author": {
    "name": "SetupBay",
    "url": "https://setupbay.com"
  },
  "credits": [
    {
      "title": "Codex docs: custom instructions with AGENTS.md (discovery, 32 KiB project_doc_max_bytes)",
      "url": "https://developers.openai.com/codex/guides/agents-md"
    },
    {
      "title": "Claude Code docs: memory, AGENTS.md (CLAUDE.md wins unless it imports AGENTS.md)",
      "url": "https://code.claude.com/docs/en/memory"
    },
    {
      "title": "AGENTS.md format",
      "url": "https://agents.md/"
    },
    {
      "title": "@torfinpd: in 161 of 283 top repos with AGENTS.md, a CLAUDE.md shadows it",
      "url": "https://x.com/torfinpd/status/2108876607431553167"
    }
  ],
  "categories": [
    "ai-agents",
    "workflow"
  ],
  "stacks": [
    "markdown",
    "python"
  ],
  "files": [
    {
      "path": "AGENTS.md",
      "role": "instructions",
      "description": "Rules for keeping this repository's AGENTS.md files correct.",
      "skill": null,
      "agent": null,
      "install_to": {
        "claude-code": "AGENTS.md",
        "codex": "AGENTS.md",
        "cursor": "AGENTS.md",
        "gemini-cli": "AGENTS.md",
        "antigravity-cli": "AGENTS.md",
        "copilot": "AGENTS.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/AGENTS.md",
      "bytes": 1115,
      "lang": "markdown",
      "content": "# AGENTS.md: keeping this repository's AGENTS.md right\n\nThis repository's `AGENTS.md` files are instructions for every coding agent that works here. Treat them like code:\nthey must be correct, short and checked.\n\n## When you change an AGENTS.md\n- Use the `agents-md-writer` skill. It has seven worked examples and a lint script.\n- Every command in it must exist and work. Run it before you write it down.\n- Keep the five parts: what the project is, Commands, Layout, Conventions and Never, Done means.\n- Keep each file under 150 lines and the root-to-folder chain under 32 KiB.\n- A CLAUDE.md must import `AGENTS.md` with a line `@AGENTS.md`; never put different rules in the two files.\n\n## When the code changes\nIf you rename a script, move a folder or change the test runner, update the AGENTS.md that mentions it in the same\nchange, and run the lint again.\n\n## Never\n- Write a command you have not run, or one copied from another project\n- Put rules in CLAUDE.md, GEMINI.md or Cursor rules that contradict AGENTS.md\n\n## Done means\nThe lint prints `0 error(s)`, and every warning left is explained in your report.\n"
    },
    {
      "path": "CLAUDE.md",
      "role": "adapter",
      "description": "Imports AGENTS.md for Claude Code.",
      "skill": null,
      "agent": "claude-code",
      "install_to": {
        "claude-code": "CLAUDE.md",
        "codex": null,
        "cursor": null,
        "gemini-cli": null,
        "antigravity-cli": null,
        "copilot": null
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/CLAUDE.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/CLAUDE.md",
      "bytes": 389,
      "lang": "markdown",
      "content": "# CLAUDE.md\n\n@AGENTS.md\n\n## Claude Code notes\n\n- Skills from this loadout live in `.claude/skills/`: `agents-md-writer`. Use them when their description matches the task.\n- Follow AGENTS.md above; where this file and AGENTS.md disagree, AGENTS.md wins.\n\n<!-- From SetupBay \"AGENTS.md examples for seven kinds of repository\" v1.0.0 — https://setupbay.com/loadouts/agents-md-examples/ -->\n"
    },
    {
      "path": "GEMINI.md",
      "role": "adapter",
      "description": "Imports AGENTS.md for Gemini CLI.",
      "skill": null,
      "agent": "gemini-cli",
      "install_to": {
        "claude-code": null,
        "codex": null,
        "cursor": null,
        "gemini-cli": "GEMINI.md",
        "antigravity-cli": null,
        "copilot": null
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/GEMINI.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/GEMINI.md",
      "bytes": 390,
      "lang": "markdown",
      "content": "# GEMINI.md\n\n@./AGENTS.md\n\n## Gemini CLI notes\n\n- Skills from this loadout live in `.agents/skills/`: `agents-md-writer`. Use them when their description matches the task.\n- Follow AGENTS.md above; where this file and AGENTS.md disagree, AGENTS.md wins.\n\n<!-- From SetupBay \"AGENTS.md examples for seven kinds of repository\" v1.0.0 — https://setupbay.com/loadouts/agents-md-examples/ -->\n"
    },
    {
      "path": "skills/agents-md-writer/SKILL.md",
      "role": "skill",
      "description": "Pick an example, fill it from the repo, lint it.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/SKILL.md",
        "codex": ".agents/skills/agents-md-writer/SKILL.md",
        "cursor": ".agents/skills/agents-md-writer/SKILL.md",
        "gemini-cli": ".agents/skills/agents-md-writer/SKILL.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/SKILL.md",
        "copilot": ".agents/skills/agents-md-writer/SKILL.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/SKILL.md",
      "bytes": 2667,
      "lang": "markdown",
      "content": "---\nname: agents-md-writer\ndescription: Write or fix a repository's AGENTS.md from worked examples, then lint it against what Codex, Claude Code and the others actually load. Use when creating an AGENTS.md, when agents ignore or misread it, when adding a nested AGENTS.md in a monorepo, or when asked for AGENTS.md examples.\n---\n\n# Write an AGENTS.md that agents follow\n\nAGENTS.md is read by Codex, Cursor, Copilot, Antigravity CLI and Claude Code (when no CLAUDE.md shadows it). It is\nloaded into every session, so every line costs context and every wrong command wastes a run.\n\n## 1. Pick the nearest example\n`references/examples/` has seven, each 30–40 lines:\n\n| File | For |\n|---|---|\n| `web-app.md` | Next.js / TypeScript app with a database |\n| `python-library.md` | a published Python package (uv, pytest, ruff, mypy) |\n| `monorepo-root.md` + `monorepo-api.md` | a root file plus a nested one for one app |\n| `go-cli.md` | a Go command-line tool with golden files |\n| `godot-game.md` | a Godot 4 game |\n| `infra-opentofu.md` | OpenTofu / Terraform, plan only |\n\nCopy the structure, not the content. Every example has the same five parts: one line on what the project is;\n**Commands** (exact, copy-pasteable, including how to run one test); **Layout**; **Conventions** and **Never**;\n**Done means**.\n\n## 2. Fill it from the repository, not from memory\n- Read `package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`, CI workflows. Use the commands that exist.\n  Run each one once; if it fails, fix the command or leave it out.\n- Write what an agent would get wrong here: the package manager, the test runner, generated folders, the database\n  rule. Leave out what any agent already knows (\"write clean code\").\n- Keep it under 150 lines. Longer procedures belong in skills.\n- Monorepo: a short root file with rules for every package, and a nested `AGENTS.md` per app with its commands.\n  Codex joins them root first and stops at 32 KiB in total.\n- If the repo has a CLAUDE.md, make it import AGENTS.md (a line with `@AGENTS.md`). Otherwise Claude Code reads\n  CLAUDE.md only and ignores AGENTS.md.\n\n## 3. Lint it\n```bash\npython3 .agents/skills/agents-md-writer/scripts/agents_md_lint.py .\n```\n(Claude Code installs the skill under `.claude/skills/`.) Fix every error: a size over Codex's 32 KiB, a shadowing\nCLAUDE.md, an `npm run` / `pnpm` / `make` / `just` command that does not exist. Fix or explain each warning: no\ntest command, no \"Never\" section, over 150 lines, a path that does not exist. The `info` lines show which files Codex\njoins for each folder.\n\n## 4. Report\nShow the final file, the lint summary, and each command you ran to check it.\n"
    },
    {
      "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
      "role": "reference",
      "description": "Read-only lint for AGENTS.md files.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/scripts/agents_md_lint.py",
        "codex": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
        "cursor": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
        "gemini-cli": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
        "antigravity-cli": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
        "copilot": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/scripts/agents_md_lint.py",
      "bytes": 7356,
      "lang": "markdown",
      "content": "#!/usr/bin/env python3\n\"\"\"Lint the AGENTS.md files in a repository against what agents actually load.\n\nUsage: python3 agents_md_lint.py [REPO_DIR]     (default: the current folder)\n\nFor every AGENTS.md (root and nested; skips node_modules, .git, vendor, dist, build, .venv):\n  error  combined size of the AGENTS.md chain is over Codex's default 32 KiB project_doc_max_bytes (the rest is not read)\n  error  a CLAUDE.md or CLAUDE.local.md sits beside it without importing it (@AGENTS.md), so Claude Code reads only CLAUDE.md\n  error  a referenced script does not exist: `npm run X` / `pnpm X` / `yarn X` (package.json scripts), `make X` (Makefile targets),\n         `just X` (justfile recipes)\n  warn   no section that tells the agent how to test or check its work\n  warn   no \"never\" / \"don't\" section (the agent has no boundaries)\n  warn   over 150 lines (agents follow short files better; move procedures into skills)\n  warn   a backticked path such as `src/lib/` that does not exist\n  info   files Codex would read for each nested AGENTS.md, root first\nExit 1 if any error, else 0. Standard library only; read-only.\n\"\"\"\nimport json\nimport os\nimport re\nimport sys\n\nSKIP = {\"node_modules\", \".git\", \"vendor\", \"dist\", \"build\", \".venv\", \"venv\", \"target\", \".next\", \".godot\", \"__pycache__\"}\nCODEX_MAX = 32 * 1024\nTEST_HINT = re.compile(r\"^#+.*\\b(test|tests|testing|check|checks|verify|done)\\b|`[^`]*\\b(test|pytest|vitest|jest|check|validate|lint)\\b[^`]*`\", re.I | re.M)\nNEVER_HINT = re.compile(r\"^#+\\s*(never|don'?t|do not|boundaries|off limits|ask first)\\b|^\\s*[-*]\\s*(never|do not|don'?t)\\b\", re.I | re.M)\nCODE_SPAN = re.compile(r\"`([^`\\n]+)`\")\nRUN_SCRIPT = re.compile(r\"\\b(?:npm run|pnpm(?: run)?|yarn(?: run)?|bun run)\\s+([A-Za-z0-9:_-]+)\")\nPNPM_BUILTINS = {\"install\", \"i\", \"add\", \"remove\", \"exec\", \"dlx\", \"turbo\", \"--filter\", \"-r\", \"why\", \"update\", \"outdated\", \"audit\", \"store\", \"run\", \"x\", \"create\", \"init\"}\nMAKE = re.compile(r\"^make\\s+([A-Za-z0-9_.-]+)\")\nJUST = re.compile(r\"^just\\s+([A-Za-z0-9_-]+)\")\nPATHLIKE = re.compile(r\"^((?:\\.?[A-Za-z0-9_-]+/)+(?:[A-Za-z0-9_.-]+)?)$\")\nGENERATED = (\".next/\", \"dist/\", \"build/\", \"node_modules/\", \".godot/\", \"target/\", \".venv/\", \"coverage/\")\n\n\ndef find_agents(root):\n    for d, dirs, files in os.walk(root):\n        dirs[:] = sorted(x for x in dirs if x not in SKIP and not x.startswith(\".\") or x in (\".github\",))\n        if \"AGENTS.md\" in files:\n            yield os.path.join(d, \"AGENTS.md\")\n\n\ndef nearest(start, root, name):\n    d = start\n    while True:\n        p = os.path.join(d, name)\n        if os.path.isfile(p):\n            return p\n        if os.path.abspath(d) == os.path.abspath(root):\n            return None\n        d = os.path.dirname(d)\n\n\ndef scripts_for(dirpath, root):\n    pj = nearest(dirpath, root, \"package.json\")\n    if not pj:\n        return None, None\n    try:\n        return set(json.load(open(pj)).get(\"scripts\", {})), pj\n    except ValueError:\n        return set(), pj\n\n\ndef make_targets(dirpath, root):\n    mk = nearest(dirpath, root, \"Makefile\")\n    if not mk:\n        return None\n    return set(re.findall(r\"^([A-Za-z0-9_.-]+)\\s*:(?!=)\", open(mk).read(), re.M))\n\n\ndef just_recipes(dirpath, root):\n    jf = nearest(dirpath, root, \"justfile\") or nearest(dirpath, root, \"Justfile\")\n    if not jf:\n        return None\n    return set(re.findall(r\"^@?([A-Za-z0-9_-]+)[^:\\n]*:(?!=)\", open(jf).read(), re.M))\n\n\ndef chain(path, root):\n    \"\"\"AGENTS.md files Codex concatenates when started in path's folder: root first.\"\"\"\n    out, d = [], os.path.dirname(path)\n    while True:\n        p = os.path.join(d, \"AGENTS.md\")\n        o = os.path.join(d, \"AGENTS.override.md\")\n        if os.path.isfile(o):\n            out.append(o)\n        elif os.path.isfile(p):\n            out.append(p)\n        if os.path.abspath(d) == os.path.abspath(root):\n            break\n        d = os.path.dirname(d)\n    return list(reversed(out))\n\n\ndef main(argv):\n    root = argv[0] if argv else \".\"\n    files = list(find_agents(root))\n    if not files:\n        print(\"agents-md-lint: no AGENTS.md found\")\n        return 1\n    errors = warns = 0\n\n    def report(level, path, msg):\n        nonlocal errors, warns\n        errors += level == \"error\"\n        warns += level == \"warn\"\n        print(f\"{level:5} {os.path.relpath(path, root)}: {msg}\")\n\n    for path in files:\n        d = os.path.dirname(path)\n        text = open(path, encoding=\"utf-8\").read()\n        lines = text.count(\"\\n\") + 1\n        ch = chain(path, root)\n        size = sum(os.path.getsize(p) for p in ch)\n        if size > CODEX_MAX:\n            report(\"error\", path, f\"AGENTS.md chain is {size} bytes; Codex stops reading at {CODEX_MAX} (project_doc_max_bytes)\")\n        for cname in (\"CLAUDE.md\", \"CLAUDE.local.md\"):\n            c = os.path.join(d, cname)\n            if os.path.isfile(c) and not re.search(r\"^\\s*@(\\./)?AGENTS\\.md\\s*$\", open(c).read(), re.M):\n                report(\"error\", path, f\"{cname} next to it does not import it with @AGENTS.md, so Claude Code reads {cname} only\")\n        scripts, pj = scripts_for(d, root)\n        spans = [m.group(1).strip() for m in CODE_SPAN.finditer(text)]\n        cmds = [c for sp in spans for c in re.split(r\"\\s*(?:&&|\\|\\||;|\\bthen\\b)\\s*\", sp)]\n        for m in (x for c in cmds for x in RUN_SCRIPT.finditer(c)):\n            name = m.group(1)\n            if name in PNPM_BUILTINS or name.startswith(\"-\"):\n                continue\n            if scripts is None:\n                report(\"warn\", path, f\"mentions script '{name}' but no package.json was found\")\n            elif name not in scripts:\n                report(\"error\", path, f\"script '{name}' is not in {os.path.relpath(pj, root)} scripts\")\n        targets = make_targets(d, root)\n        for m in (x for c in cmds for x in [MAKE.match(c)] if x):\n            if targets is not None and m.group(1) not in targets:\n                report(\"error\", path, f\"make target '{m.group(1)}' is not in the Makefile\")\n        recipes = just_recipes(d, root)\n        for m in (x for c in cmds for x in [JUST.match(c)] if x):\n            if recipes is not None and m.group(1) not in recipes:\n                report(\"error\", path, f\"just recipe '{m.group(1)}' is not in the justfile\")\n        if not TEST_HINT.search(text):\n            report(\"warn\", path, \"nothing says how to test or check work (add the exact test command and what done means)\")\n        if not NEVER_HINT.search(text):\n            report(\"warn\", path, \"no 'Never' section; list what the agent must not touch or run\")\n        if lines > 150:\n            report(\"warn\", path, f\"{lines} lines; keep it short and move procedures into skills\")\n        for m in (x for sp in spans for x in [PATHLIKE.match(sp)] if x):\n            rel = m.group(1)\n            if \"<\" in rel or \"*\" in rel or rel.startswith((\"http\", \"~\", \"/\")) or rel.startswith(GENERATED):\n                continue\n            if not (os.path.exists(os.path.join(d, rel)) or os.path.exists(os.path.join(root, rel))):\n                report(\"warn\", path, f\"path `{rel}` does not exist\")\n        print(f\"info  {os.path.relpath(path, root)}: {lines} lines, {len(text.encode())} bytes; Codex reads: {' + '.join(os.path.relpath(p, root) for p in ch)}\")\n    print(f\"agents-md-lint: {len(files)} file(s), {errors} error(s), {warns} warning(s)\")\n    return 1 if errors else 0\n\n\nif __name__ == \"__main__\":\n    sys.exit(main(sys.argv[1:]))\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/web-app.md",
      "role": "reference",
      "description": "Next.js + TypeScript + Postgres app.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/web-app.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/web-app.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/web-app.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/web-app.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/web-app.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/web-app.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/web-app.md",
      "bytes": 1423,
      "lang": "markdown",
      "content": "# AGENTS.md\n\nNext.js 16 (App Router) + TypeScript strict + Postgres via Drizzle. pnpm only.\n\n## Commands\n- Install: `pnpm install --frozen-lockfile`\n- Dev server: `pnpm dev` (http://localhost:3000; reuse a running one, check `.next/dev/lock`)\n- Type check: `pnpm typecheck`\n- Lint and format: `pnpm lint` then `pnpm format`\n- Unit tests: `pnpm test` · one file: `pnpm test src/lib/price.test.ts`\n- End-to-end: `pnpm e2e` (needs the dev server)\n- DB migration: `pnpm db:generate` writes SQL to `drizzle/`; never run `db:push` against a shared database\n\n## Layout\n- `app/` routes; server components by default, `\"use client\"` only for interactivity\n- `src/lib/` pure logic with unit tests next to it; `src/db/` schema and queries; `src/components/` UI\n\n## Conventions\n- Server actions validate input with zod and return `{ ok, error }`; never throw to the client\n- Money is integer pence; dates are UTC `Date` objects, formatted only in components\n- New UI uses the existing components in `src/components/ui/`; no new UI libraries\n\n## Never\n- Commit `.env*` files or print secrets; add new variables to `.env.example` with a dummy value\n- Edit `drizzle/` migrations that are already merged; write a new one\n- Disable a lint rule or a test to get green\n\n## Done means\n`pnpm typecheck && pnpm lint && pnpm test` pass, the changed page was opened in the browser and works, and the\nPR description says what you checked by hand.\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/python-library.md",
      "role": "reference",
      "description": "Published Python library with uv.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/python-library.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/python-library.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/python-library.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/python-library.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/python-library.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/python-library.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/python-library.md",
      "bytes": 1237,
      "lang": "markdown",
      "content": "# AGENTS.md\n\n`tidyparse`: a pure-Python library for parsing messy CSV exports. Supports Python 3.11 and later. Published to PyPI.\n\n## Commands\n- Set up: `uv sync`\n- Tests: `uv run pytest -q` · one test: `uv run pytest -q tests/test_dates.py::test_iso_week`\n- Lint and format: `uv run ruff check --fix` then `uv run ruff format`\n- Types: `uv run mypy src`\n- Docs preview: `uv run mkdocs serve`\n\n## Layout\n- `src/tidyparse/` the package; public API is exactly what `__init__.py` exports\n- `tests/` mirrors `src/`; fixtures (sample CSVs) in `tests/data/`\n\n## Conventions\n- No new runtime dependencies without asking; dev dependencies go in the `dev` group\n- Every public function has type hints and a docstring with one example\n- Changes to public behaviour get a line in `CHANGELOG.md` under \"Unreleased\"\n- Keep Python 3.11 compatible: no `type` statements or 3.12+ only syntax\n\n## Never\n- Change the public API (names, arguments, return types) without saying so first; it breaks users\n- Bump the version or publish; releases are done by a maintainer\n- Edit `tests/data/` files to make a test pass\n\n## Done means\n`uv run pytest -q`, `uv run ruff check` and `uv run mypy src` pass, new behaviour has a test, and `CHANGELOG.md` is updated.\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
      "role": "reference",
      "description": "Monorepo root file.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/monorepo-root.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/monorepo-root.md",
      "bytes": 940,
      "lang": "markdown",
      "content": "# AGENTS.md (repository root)\n\nMonorepo: `apps/web` (React + Vite), `apps/api` (Fastify), `packages/shared` (types and zod schemas). Turborepo + pnpm workspaces.\nEach app has its own `AGENTS.md` with its commands; read the one nearest to the files you change.\n\n## Commands (from the root)\n- Install: `pnpm install --frozen-lockfile`\n- Everything: `pnpm turbo run build test lint`\n- One package: `pnpm --filter @acme/api test`\n\n## Rules for every package\n- Shared types live in `packages/shared`; never copy a type into an app\n- A change to `packages/shared` must build and test every app that depends on it: `pnpm turbo run test --filter=...@acme/shared`\n- Add dependencies to the package that uses them, never to the root `package.json`\n- One concern per pull request; do not mix a refactor with a feature\n\n## Never\n- Edit generated files (`**/dist/`, `apps/api/src/generated/`)\n- Change CI (`.github/`) or Turborepo config without asking\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
      "role": "reference",
      "description": "Nested file for one app in the monorepo.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/monorepo-api.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/monorepo-api.md",
      "bytes": 1058,
      "lang": "markdown",
      "content": "# AGENTS.md (apps/api)\n\nFastify 5 API on Node 24. Postgres via Kysely. Read the root `AGENTS.md` first; this file adds API rules.\n\n## Commands (from apps/api)\n- Dev: `pnpm dev` (port 4000) · tests: `pnpm test` · one: `pnpm test src/routes/orders.test.ts`\n- Migrations: `pnpm migrate:new <name>` creates a file in `migrations/`; `pnpm migrate:up` runs them locally only\n\n## Rules\n- Every route declares a zod schema from `@acme/shared` for body, params and response\n- Handlers stay thin: validation and HTTP in `src/routes/`, logic in `src/services/` with unit tests\n- Errors use `httpErrors` from `@fastify/sensible`; never leak stack traces or SQL to clients\n- Queries are parameterised through Kysely; no string-built SQL\n\n## Never\n- Run migrations against anything but your local database\n- Return database rows straight to clients; map them to the shared response schema\n\n## Done means\n`pnpm test` passes here and in `apps/web` if you changed a shared schema, and you called the changed route locally\nwith a real request and saw the expected response.\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/go-cli.md",
      "role": "reference",
      "description": "Go command-line tool.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/go-cli.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/go-cli.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/go-cli.md",
      "bytes": 1199,
      "lang": "markdown",
      "content": "# AGENTS.md\n\n`shipctl`: a Go 1.27 command-line tool for managing deploy manifests. Single binary, no CGO.\n\n## Commands\n- Build: `go build ./...` · run: `go run ./cmd/shipctl --help`\n- Tests: `go test ./...` · race: `go test -race ./...` · one: `go test ./internal/manifest -run TestMerge`\n- Lint: `golangci-lint run`\n- Golden files: `go test ./internal/render -update` rewrites `testdata/*.golden`; only after reading the diff\n\n## Layout\n- `cmd/shipctl/` flags and wiring only; `internal/` everything else; no pkg folder\n- `testdata/` inputs and golden outputs for table-driven tests\n\n## Conventions\n- Errors wrap with context: `fmt.Errorf(\"load %s: %w\", path, err)`; no panics outside `main`\n- Flags are kebab-case and documented in `--help`; any new flag is added to `docs/cli.md`\n- Output: human text by default, `--json` for machines; never change existing JSON field names\n- Standard library first; ask before adding a module\n\n## Never\n- Accept updated golden files without reading the diff\n- Change exit codes (0 ok, 1 error, 2 usage); scripts depend on them\n\n## Done means\n`go test -race ./...` and `golangci-lint run` pass, and you ran the changed command for real and pasted its output.\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/godot-game.md",
      "role": "reference",
      "description": "Godot 4 game.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/godot-game.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/godot-game.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/godot-game.md",
      "bytes": 975,
      "lang": "markdown",
      "content": "# AGENTS.md\n\nA 2D platformer in **Godot 4.7** (GDScript 2.0). Not Godot 3: no `yield`, `export var`, `onready`, `KinematicBody2D`.\n\n## Commands\n- Check one script: `godot --headless --path . --check-only --script res://scenes/player/player.gd`\n- Run headless for errors: `godot --headless --path . --quit-after 300`\n- Tests (GUT): `godot --headless --path . -s addons/gut/gut_cmdln.gd -gexit`\n\n## Layout\n- `scenes/<thing>/` with the `.tscn` next to its `.gd`; `autoload/` for the few global singletons; `assets/` imported files\n\n## Conventions\n- Static types everywhere; `@export` for values a designer tunes; signals up, calls down\n- Input actions from the Input Map (`move_left`, `jump`), never raw key codes\n\n## Never\n- Hand-edit `.tscn` files beyond small property changes; never edit `.godot/`\n- Add plugins to `addons/` without asking\n\n## Done means\nNo `SCRIPT ERROR` from `--check-only` or the headless run, tests pass, and you told the human what to try in the game.\n"
    },
    {
      "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
      "role": "reference",
      "description": "OpenTofu, plan only.",
      "skill": "agents-md-writer",
      "agent": null,
      "install_to": {
        "claude-code": ".claude/skills/agents-md-writer/references/examples/infra-opentofu.md",
        "codex": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
        "cursor": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
        "gemini-cli": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
        "antigravity-cli": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
        "copilot": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md"
      },
      "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
      "raw_latest_url": "https://setupbay.com/raw/agents-md-examples/latest/skills/agents-md-writer/references/examples/infra-opentofu.md",
      "bytes": 1133,
      "lang": "markdown",
      "content": "# AGENTS.md\n\nOpenTofu 1.13 modules and environments for AWS. Agents **plan only**; humans apply.\n\n## Commands\n- Format: `tofu fmt -recursive`\n- Validate a module: `cd modules/<name> && tofu init -backend=false && tofu validate`\n- Plan an environment: `cd envs/staging && tofu init && tofu plan -out=plan.bin` (read-only credentials)\n- Policy scan: `checkov -d modules --quiet`\n\n## Layout\n- `modules/` reusable modules with `variables.tf`, `outputs.tf`, `README.md`; `envs/<env>/` one root per environment\n\n## Rules\n- Pin providers with `~>` in `versions.tf`; commit `.terraform.lock.hcl`\n- Every new variable has a type, a description and validation where it can be wrong\n- Tag every resource through the module's `tags` variable\n\n## Never\n- Run `tofu apply`, `tofu destroy`, `tofu state` or `tofu import`; ask the human\n- Put secrets in `.tf` or `.tfvars` files; use the secrets manager data source\n- Edit `envs/production/` unless the task names it\n\n## Done means\n`tofu fmt -check`, `tofu validate` and `checkov` pass, and the plan output for the changed environment is in your\nreport with every create, change and destroy listed.\n"
    }
  ],
  "requires": {
    "tools": [
      "python3"
    ],
    "env": [],
    "mcp": []
  },
  "tested": {
    "status": "untested",
    "last_run": null,
    "fixture": null,
    "per_agent": {
      "claude-code": "untested",
      "codex": "untested",
      "cursor": "untested",
      "gemini-cli": "untested",
      "antigravity-cli": "untested",
      "copilot": "untested"
    }
  },
  "security": {
    "scanned": true,
    "scanner": "intake-precheck/2",
    "verdict": "clean",
    "network": false,
    "scripts": [
      "agents_md_lint.py"
    ],
    "notes": "The lint only reads AGENTS.md, CLAUDE.md, package.json, Makefile and justfile files and prints a report. It changes nothing and makes no network calls."
  },
  "featured": false,
  "deprecated": false,
  "last_checked": "2026-10-24",
  "published": "2026-10-24",
  "updated": "2026-10-24",
  "compatibility": {
    "claude-code": "native",
    "codex": "native",
    "cursor": "native",
    "gemini-cli": "native",
    "antigravity-cli": "native",
    "copilot": "native"
  },
  "counts": {
    "rules": 1,
    "skills": 1,
    "mcp": 0
  },
  "url": "https://setupbay.com/loadouts/agents-md-examples/",
  "api_url": "https://setupbay.com/api/loadouts/agents-md-examples.json",
  "verification": {
    "level": "verified-install",
    "status": "verified",
    "label": "Verified install",
    "verified": true,
    "checked_at": "2026-10-24T10:30:13Z",
    "commit": "42646ff9a52315018c9b0947c291c7ad980e1dc7",
    "content_current": true,
    "agent_tests": "not-run",
    "counts": {
      "pass": 9,
      "fail": 0,
      "skip": 0,
      "not_applicable": 1
    },
    "meaning": "Level 1: automated checks on the files (parse, install paths, MCP config, safety scan, references, size, licence, starter build). No AI agent was run.",
    "checks": [
      {
        "id": "listing",
        "name": "Listing",
        "status": "pass",
        "summary": "Schema valid; 12 files declared, none missing or extra",
        "details": [
          "tested.status: untested (agent tests are separate from Level 1)"
        ]
      },
      {
        "id": "parse",
        "name": "Files parse",
        "status": "pass",
        "summary": "All 12 files parse; front matter valid",
        "details": []
      },
      {
        "id": "adapters",
        "name": "Adapters",
        "status": "pass",
        "summary": "CLAUDE.md and GEMINI.md import AGENTS.md and are up to date",
        "details": [
          "CLAUDE.md: matches the generator",
          "GEMINI.md: matches the generator"
        ]
      },
      {
        "id": "install-paths",
        "name": "Install paths",
        "status": "pass",
        "summary": "Correct paths for all 6 agents; layouts re-discovered",
        "details": [
          "Claude Code: 11 files, 1 skill in .claude/skills/",
          "Codex CLI: 10 files, 1 skill in .agents/skills/",
          "Cursor: 10 files, 1 skill in .agents/skills/",
          "Gemini CLI: 11 files, 1 skill in .agents/skills/",
          "Antigravity CLI: 10 files, 1 skill in .agents/skills/",
          "GitHub Copilot: 10 files, 1 skill in .agents/skills/"
        ]
      },
      {
        "id": "mcp",
        "name": "MCP config",
        "status": "n/a",
        "summary": "No MCP servers in this loadout",
        "details": []
      },
      {
        "id": "safety",
        "name": "Safety scan",
        "status": "pass",
        "summary": "Clean: no credentials, risky shell, hidden text or covert instructions",
        "details": [
          "Scanner intake-precheck/2: verdict clean; network no (listing says no)"
        ]
      },
      {
        "id": "references",
        "name": "References",
        "status": "pass",
        "summary": "5 references between files resolve for every agent",
        "details": []
      },
      {
        "id": "size",
        "name": "Size limits",
        "status": "pass",
        "summary": "12 files, 19.4 KB total; largest skills/agents-md-writer/scripts/agents_md_lint.py 7.2 KB",
        "details": [
          "Limits: 30 files, 32 KB per file, 128 KB total, 500 lines per skill or rule"
        ]
      },
      {
        "id": "licence",
        "name": "Licence",
        "status": "pass",
        "summary": "MIT, by SetupBay; text in the repository LICENSE",
        "details": []
      },
      {
        "id": "starter-build",
        "name": "Starter build",
        "status": "pass",
        "summary": "Each of the seven AGENTS.md examples, placed in a small project with the scripts and folders it names, passes the agents-md-writer lint with no errors or warnings. A broken repo is caught on every rule: a CLAUDE.md that shadows AGENTS.md, a pnpm script and a make target that don't exist, no test com",
        "details": [
          "Applied 21 loadout files at every agent's paths",
          "✓ build one project per example: bash setup.sh",
          "✓ every example lints clean: bash -c for p in p/*; do echo \"== $p\"; python3 .agents/skills/agents-md-writer/scripts/agents_md_lint.py $p || echo \"FAILED $p\"; done",
          "✓ the loadout's own AGENTS.md and its CLAUDE.md import pass: bash -c mkdir -p own && cp AGENTS.md CLAUDE.md own/ && python3 .agents/skills/agents-md-writer/scripts/agents_md_lint.py own",
          "✓ a broken repository is caught on every rule: bash -c bash bad.sh && cd bad && python3 ../.agents/skills/agents-md-writer/scripts/agents_md_lint.py .; echo \"exit=$?\"",
          "Covers: All seven examples (web app, Python library, monorepo root and app, Go CLI, Godot game, OpenTofu) against the lint",
          "Covers: Claude Code's documented rule: a CLAUDE.md that doesn't import AGENTS.md is read instead of it",
          "Covers: Codex's documented 32 KiB project_doc_max_bytes across a root-to-folder chain",
          "Covers: Commands checked against package.json scripts and Makefile targets",
          "Covers: Not covered: whether an agent follows the file (agent tests are separate)"
        ]
      }
    ]
  },
  "install": {
    "claude-code": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "CLAUDE.md",
          "target": "CLAUDE.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/CLAUDE.md",
          "role": "adapter"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".claude/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".claude/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".claude/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".claude/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".claude/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".claude/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".claude/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".claude/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".claude/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/claude-code.zip"
    },
    "codex": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".agents/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".agents/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".agents/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/codex.zip"
    },
    "cursor": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".agents/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".agents/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".agents/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/cursor.zip"
    },
    "gemini-cli": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "GEMINI.md",
          "target": "GEMINI.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/GEMINI.md",
          "role": "adapter"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".agents/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".agents/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".agents/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/gemini-cli.zip"
    },
    "antigravity-cli": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".agents/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".agents/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".agents/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/antigravity-cli.zip"
    },
    "copilot": {
      "files": [
        {
          "path": "AGENTS.md",
          "target": "AGENTS.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/AGENTS.md",
          "role": "instructions"
        },
        {
          "path": "skills/agents-md-writer/SKILL.md",
          "target": ".agents/skills/agents-md-writer/SKILL.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/SKILL.md",
          "role": "skill"
        },
        {
          "path": "skills/agents-md-writer/scripts/agents_md_lint.py",
          "target": ".agents/skills/agents-md-writer/scripts/agents_md_lint.py",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/scripts/agents_md_lint.py",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/web-app.md",
          "target": ".agents/skills/agents-md-writer/references/examples/web-app.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/web-app.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/python-library.md",
          "target": ".agents/skills/agents-md-writer/references/examples/python-library.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/python-library.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-root.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-root.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-root.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/monorepo-api.md",
          "target": ".agents/skills/agents-md-writer/references/examples/monorepo-api.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/monorepo-api.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/go-cli.md",
          "target": ".agents/skills/agents-md-writer/references/examples/go-cli.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/go-cli.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/godot-game.md",
          "target": ".agents/skills/agents-md-writer/references/examples/godot-game.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/godot-game.md",
          "role": "reference"
        },
        {
          "path": "skills/agents-md-writer/references/examples/infra-opentofu.md",
          "target": ".agents/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "raw_url": "https://setupbay.com/raw/agents-md-examples/1.0.0/skills/agents-md-writer/references/examples/infra-opentofu.md",
          "role": "reference"
        }
      ],
      "manual_steps": [],
      "zip_url": "https://setupbay.com/download/agents-md-examples/copilot.zip"
    }
  },
  "source_zip_url": "https://setupbay.com/download/agents-md-examples/source.zip"
}