Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/rtorcato/repo-tooling/agents-mdgit clone --depth 1 https://github.com/rtorcato/repo-toolingWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/rtorcato/repo-tooling/agents-md)<a href="https://agentmods.dev/instructions/rtorcato/repo-tooling/agents-md"><img src="https://agentmods.dev/badge/instructions/rtorcato/repo-tooling/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.02269 | $0.02269 |
| Opus 5 | $0.01135 | $0.01135 |
| Sonnet 5 | $0.00454 | $0.00454 |
| Haiku 4.5 | $0.00227 | $0.00227 |
Grade A, and why
repo-tooling AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Orientation for coding agents working with @rtorcato/repo-tooling. Human-readable docs live at https://rtorcato.github.io/repo-tooling/.
What this is
A one-package JavaScript / TypeScript tooling distribution. Ships every preset (TypeScript, Biome, ESLint, Prettier, Vitest, Jest, Commitlint, semantic-release, tsup, esbuild, Vite, Playwright) plus a CLI to scaffold and audit projects. Consumers get one install.
Swift repos (detected via Package.swift) are covered end to end: setup --preset swift-library scaffolds a SwiftPM package, and doctor/fix run the language-agnostic checks plus SwiftLint / Periphery / .gitignore / Package.swift. Python repos (detected via pyproject.toml / setup.py) get doctor/fix — Ruff / mypy / pytest / .gitignore / CI / git hooks — but no setup preset yet. Perl distributions (detected via cpanfile / Makefile.PL / dist.ini) get the same deal: Perl::Critic / perltidy / .gitignore / CI / git hooks, no setup preset. See src/languages/ — one directory per language module, src/base/ for what's shared.
CLI surface (agent-friendly)
Every command supports --json and a non-interactive mode. Combine with --yes for fully autonomous use.
| Command | Non-interactive | JSON output | Use case |
|---|---|---|---|
setup --preset <name> |
✅ (non-TTY, or with --yes) |
--dry-run only |
Scaffold a new project. Presets: minimal, library, web-app, node-api, nextjs-app, react-app, swift-library. In an interactive terminal it first prints the file list and lets you deselect; pass --yes for the one-shot behaviour. |
setup --config <path> |
✅ | --dry-run only |
Scaffold with a full ProjectConfig JSON file. See setup --config-schema. |
setup --config-schema |
✅ | ✅ (JSON Schema) | Print the JSON Schema for ProjectConfig. Use to validate configs before scaffolding. |
setup --dry-run |
✅ | ✅ | Print resolved config + file list without writing. Pair with --preset or --config. |
doctor --json |
✅ | ✅ | Audit a project. Returns { directory, results: [{ check, status, detail, hint? }] }. Status: ok / drift / missing / optional-missing / declared. |
doctor --rules-from <owner/repo> |
✅ | ✅ | Report how this repo's config/rules differ from a reference repo's .repo-tooling.json (read over gh). Informational only — adds a rulesReference key to the JSON, never a check result, never affects the exit code. |
setup --from <owner/repo> |
❌ (seeds the wizard) | --dry-run only |
Seed the wizard's defaults from a reference repo's recorded config. Seeded, not skipped — every question is still asked. |
fix --json --yes |
✅ | ✅ | Walk every doctor finding, apply fixers. Returns FixActionRecord[] with `status: applied |
fix <target> --json --yes |
✅ | ✅ | Apply one fixer. Targets from list --json. |
fix --dry-run |
✅ | ✅ | Print what each fixer would write without writing. Combine with --json. |
list --json |
✅ | ✅ | Enumerate the library's surface area. Each entry has { name, description, exports, fixTarget }. |
copy <name> |
✅ | text only | Copy a single preset (biome, tsconfig) into the current directory. |
loop guard --root <path> |
✅ | ✅ | Guard an ai-issue-loop tick: repair a wrongly-bare main checkout, gate the node_modules rebuild (--removed). Exit 0 continue, 1 repair failed, 2 root is not a repairable checkout — both non-zero halt the tick. |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 127 lines · 2,269 tokens per session scan A 5f95f31f10d8
repo-tooling AGENTS.md is an instructions file published in the GitHub repository rtorcato/repo-tooling (2 stars, last pushed 8d ago), licensed MIT. It adds 2,269 tokens to every session, about $0.0113 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.