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/broomva/skills/agents-mdgit clone --depth 1 https://github.com/broomva/skillsWrote 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/broomva/skills/agents-md)<a href="https://agentmods.dev/instructions/broomva/skills/agents-md"><img src="https://agentmods.dev/badge/instructions/broomva/skills/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.00402 | $0.00402 |
| Opus 5 | $0.00201 | $0.00201 |
| Sonnet 5 | $0.00080 | $0.00080 |
| Haiku 4.5 | $0.00040 | $0.00040 |
Grade A, and why
skills 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.
What it actually says
AGENTS.md
Replace placeholder text and keep this file compact, command-first, and operational.
Project Overview
- Project:
<project-name> - Primary runtime(s):
<runtime> - Main entrypoint(s):
<entrypoints>
Harness Commands
Run from repository root:
| Goal | Command |
|---|---|
| Fast sanity check | make smoke |
| Static checks | make check |
| Full test suite | make test |
| CI-equivalent local run | make ci |
Constraints And Guardrails
- Prefer deterministic scripts over interactive/manual steps.
- Keep command names stable (
smoke,check,test,ci). - Update docs and scripts in the same change when workflow behavior changes.
- Avoid side effects outside the repo unless explicitly required.
Architecture Boundaries
- Parse and validate external data at boundaries.
- Keep internal data models typed and normalized.
- Keep each module focused on one responsibility.
- Document boundary ownership in
docs/ARCHITECTURE.md.
Observability Expectations
- Include
trace_idandrun_idin long-running workflow logs. - Emit structured event names for major transitions (start, step, success, failure).
- Keep event fields stable for querying and alerting.
- Maintain field definitions in
docs/OBSERVABILITY.md.
Execution Plans
- For tasks expected to exceed ~30 minutes, create/update
PLANS.mdbefore coding. - Track scope, constraints, milestones, and verification steps.
- Update status checkpoints during execution and after major decisions.
Static Analysis And Quality Gates
- Run
make checkbeforemake test. - Run
make cibefore pushing large refactors. - Treat lint/type failures as blocking.
Entropy Management
- Remove stale scripts/docs quickly.
- Keep templates and real workflows in sync.
- Run periodic harness audits:
scripts/audit_harness.sh .
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 · 61 lines · 402 tokens per session scan A 670a535f3c49
skills AGENTS.md is an instructions file published in the GitHub repository broomva/skills (3 stars, last pushed 3d ago), licensed MIT. It adds 402 tokens to every session, about $0.0020 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
agent-skills AGENTS.md
AGENTS.md instructions for magnus919/agent-skills, covering agents.md — agent guide for agent-skills, format compliance, readme format, required sections and style guidance.
gangsta AGENTS.md
Instructions for kucherenko/gangsta, covering contributing to gangsta, what this is, what will not be accepted, skill changes and the laws apply to contributors too.
gangsta GEMINI.md
Instructions for kucherenko/gangsta, a project described as: AI agentic skills framework for spec-driven development, built on the organizational model of mafia.
shisan-xinuo-workflow AGENTS.md
AGENTS.md instructions for zxc663/shisan-xinuo-workflow, covering 项目级 agent 规则 · shisan-xinuo-workflow（本仓库）, 工作流在场（本仓库会话）, 维护纪律（本 skill 正文 vs 史料——开发本 skill 时的写作规范）, 项目承载（已就绪） and 本仓库底线（区别于通用纪律）.
connectors CLAUDE.md
Claude Code instructions for zapier/connectors: Claude Code loads this file automatically. The canonical AI-agent guidance lives in AGENTS.md so that Claude Code, Codex, Cursor, and any other tool following the AGENTS.md convention read the same content.
cc-arsenal CLAUDE.md
Instructions for mgiovani/cc-arsenal, covering plugin system (recommended for claude code), then in claude code: /plugin → update now, development installation (symlink method), equivalent makefile targets and team configuration.