Skip to content
Search

Tools

AGENTS.md Checker: Lint an AGENTS.md File or System Prompt

Paste an AGENTS.md, a rules file or a system prompt, and this AGENTS.md checker reviews it the way a careful colleague would: secrets that shouldn't be there, vague lines, rules repeated or contradicted, and sections an agent needs but can't find. It runs in your browser.

What is it?

Everything happens in this tab. Nothing you type is stored or sent anywhere, and closing the tab clears it.

What to look at

Paste a file on the left to check it.

These are suggestions from simple pattern checks, not rules. A flagged line can be fine in context, and a clean result doesn't mean the file is good.

What makes a good AGENTS.md or system prompt

An AGENTS.md is a Markdown file in a repository that tells coding agents how to work in it: the commands, the conventions and the limits. A system prompt does the same job for an assistant. Both are read on every request, so every line has to earn its place.

The checker looks for the problems that make instruction files hard to follow. Vague lines like write clean code give the model a value without an action. Repeated lines cost tokens and drift apart when someone edits one copy. An always and a never about the same thing leave the model to pick one. Secrets don't belong in a file that is committed and shared, and the checker uses the same patterns as the PII redactor to find them.

For an AGENTS.md it also checks for the sections an agent needs most: the exact commands to build and run the project, how to check the work, and the boundaries it must never cross. For a system prompt it checks for boundaries only. The size panel counts lines and tokens, because the whole file sits in the context window on every turn.

Questions

Is my file uploaded?

No. The checks run in this browser tab with no network requests, and nothing is saved. Reloading the tab clears it.

How long should an AGENTS.md be?

As short as it can be while still covering the commands, the checks and the boundaries. The checker shows lines and tokens so you can see the cost, and leaves the judgement to you.

Why is a line flagged as vague?

It matched a phrase that states a value instead of an action, such as best practices or clean code. Replace it with what you actually want: the command to run, the file to copy or the rule to follow.

Does it work for other rules files?

Yes. Any Markdown or plain text instructions for a coding agent work in the AGENTS.md mode, and any assistant's instructions work in the system prompt mode.

Can it tell whether my rules are right?

No. It checks how the file is written. Whether a rule is correct for your project is still your call, and the best test is watching what the agent does with it.