agentmods.dev

agents-md-tools AGENTS.md

Project instructions for an AI coding agent working on agents-md-tools, a command-line program that checks and manages AGENTS.md files.

In plain words
What is it for?
Following project constraints, running the linter, writing tests for valid and broken examples, and preparing focused pull requests.
Why use it?
They make the agent’s allowed files, commands, testing rules, and handling of secrets clear before it changes code.

Instructions file for CodexOpenCode

2 +1 5mo ago A scan 250 tokens original MIT
View the source file bysiber/agents-md-tools
Install

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.

agentmods
npx agentmods add instructions/bysiber/agents-md-tools/agents-md
Clone the repo
git clone --depth 1 https://github.com/bysiber/agents-md-tools

Made for: Codex, OpenCode.

Per session 250 This file is loaded in full into every session.
When invoked 250 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00250 $0.00250
Opus 5 $0.00125 $0.00125
Sonnet 5 $0.00050 $0.00050
Haiku 4.5 $0.00025 $0.00025

Measured yesterday against content hash 3f2a66883ec9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agents-md-tools 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 yesterday.

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.

AGENTS.md · 33 lines

What it actually says

AGENTS.md

Project

agents-md-tools — A CLI that lints, secures, and manages AGENTS.md files for AI coding agents. Think "ESLint for AGENTS.md."

Commands

  • Install: npm install
  • Test: npm test
  • Run lint: node bin/agents-md.js lint
  • Run init: node bin/agents-md.js init
  • Dev: node bin/agents-md.js lint --file test/fixtures/valid.md

Constraints

Do NOT modify:

  • node_modules/
  • dist/
  • package-lock.json (auto-generated)
  • .env files

Do NOT read .env files or any secrets/ directory.

Only modify files in src/ and test/.

Testing instructions

  • Write tests alongside the code you change
  • All tests must pass before submitting a PR
  • Test with both valid and broken fixtures in test/fixtures/

PR instructions

  • Keep PRs focused — one feature or fix per PR
  • Include a brief description of what changed and why
  • Run agents-md lint on the project's own AGENTS.md before submitting
Changes

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.

  1. yesterday First seen · 33 lines · 250 tokens per session scan A 3f2a66883ec9

Subscribe to this mod's changes

agents-md-tools AGENTS.md is an instructions file published in the GitHub repository bysiber/agents-md-tools (2 stars, last pushed 5mo ago), licensed MIT. It adds 250 tokens to every session, about $0.0013 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.

TestingWriting and docsagentsagents-mdaiclaude-codeclicodex
Related

Other instructions, from other repositories

fastagent AGENTS.md

Instructions for fastagent-sh/fastagent, covering fastagent — agent guide, what this is, source of truth, repo map and devx principle stack.

fastagent-sh/fastagent · 6,614 tokens

agents-reverse-engineer AGENTS.md

Instructions for GeoloeG-IsT/agents-reverse-engineer, covering agents-reverse-engineer, stack, subdirectories, architecture and behavioral contracts.

GeoloeG-IsT/agents-reverse-engineer · 4,955 tokens

project-starter-template-es-ai AGENTS.md

AGENTS.md instructions for brayandiazc/project-starter-template-es-ai, covering agents.md — [nombredelproyecto], resumen del proyecto, mapa del repositorio (lee esto primero), configuración y comandos and acuerdo de trabajo.

brayandiazc/project-starter-template-es-ai · 1,074 tokens

agent-operating-protocol AGENTS.md

Instructions for ryu-tada/agent-operating-protocol, covering agents.md - agent operating protocol, 0. instruction priority and trust boundaries, 1. core operating stance, 2. why high-agency agents feel strong and 3. default work loop.

ryu-tada/agent-operating-protocol · 2,467 tokens

agentlint AGENTS.md

AGENTS.md instructions for agentlint/agentlint, covering agents.md — agentlint, project, build, test, lint, typecheck, architecture and conventions.

agentlint/agentlint · 2,439 tokens

agents-md-facts AGENTS.md

Instructions for Wolfe-Jam/agents-md-facts, covering agents.md — agents-md-facts, setup & build, run the tests, where things live and conventions.

Wolfe-Jam/agents-md-facts · 427 tokens