Why doesn’t AI mention your brand? Find out which half is brokenGet a free report
LLMention
Method

How to read a failed check and fix the right thing

Most bad fixes come from reading a failure as an instruction. The rule pages publish what each check does not test for exactly this reason; this is how to use that.

By Alex XuUpdated 24 October 20267 min read

A failed check is a claim about your page, not an instruction. The rule pages on this site publish four things for exactly that reason: the condition the scanner tests, what a failure means, what the check does not test, and the fix for each way it can fail. Reading three of those before editing is the difference between a fix and a rewrite.

The failure itself is worth a number for context. In the study of 30 homepages, 53% graded F and 7% reached a B, and almost every one of the low scores came from several unrelated rules failing together rather than from one catastrophic problem.

What does a failed check actually tell me?

That one condition was not met, with the evidence the scanner saw when it tested it. It does not tell you why, and it does not tell you the fix — those are separate sentences on the rule page.

Each rule page carries the same structure: what the check looks at, what a failure means, the steps to fix it, and a note on what the check does not test. The last one is the most useful and the most often skipped. It is where a rule admits it counts presence rather than quality — the quotation rule passes on any blockquote, and the entity rule passes on any declared type.

Does this check apply to a page like mine?

Usually, but not always. The scanner has page-type exemptions, and the report shows a count of checks that were not applicable rather than silently scoring them zero.

Word count is the clearest example. A legal page or a contact page is not going to carry 800 words of prose, and holding it to a content page’s length would measure the page type rather than the writing. If a rule appears in your list, it applied; if the report says a check was not applicable, deleting content to satisfy it is the wrong response to a failure that never happened.

Is the number about my page or about the response?

Check the status first. A 401, 403, 429, 202 or 520 means the score describes an error response, and content work cannot move it.

This is not a hypothetical: in the study, 30% of the homepages never produced a page, and their scores measure the refusal. The scanner flags them as aborted and excludes them from the mean, but the number is still printed next to the domain, so the reader has to know which kind of number they are looking at. The piece on those nine rows goes through the codes one by one.

Is it asking for a real improvement or a padded number?

Sometimes it is a number. The word count rule passes at 800 words and gives a partial pass from 300 to 799, so a page at 796 words loses points for being four words short of a threshold.

The honest responses are to say more that is worth saying, or to accept the partial pass. The dishonest one is filler, and it is worse than the missing points: a reader who notices padding trusts the rest of the page less, and the rules that follow — answer first, extractables, citations — only work on text that says something.

This site publishes a page that fails its own word count rule rather than pad it, and says so in the rule page’s note. That is the same trade stated in public, which is the only version of it a reader can check.

What does a good fix look like compared with a bad one?

The bad fix satisfies the condition. The good fix satisfies the reason the condition exists, and then the condition follows.

FailureFix that satisfies the ruleFix that satisfies the reason
Word count partial at 740 wordsAdd 60 words of restatementAdd the worked example readers keep asking for
Crawler user-agent disallowedAdd an Allow line to robots.txtCheck the CDN, because the firewall may still return 403
No quotations on the pageQuote a sentence from the page itselfQuote the primary source the claim rests on
No markdown alternateHand-write a twin that drifts within a monthGenerate it from the same source, or accept the miss

The last row is this site’s own example. The homepage has no markdown twin, the check fails, and the site publishes the failure rather than softening the rule or writing a copy that would disagree with the page it mirrors six weeks later. A rule the author cannot satisfy honestly is evidence about the rule, and it belongs in the notes rather than in a workaround.

When should I ignore a failed check?

Three cases, all of which should be written down: the rule does not apply, the trade is deliberate, or the fix costs more than the points are worth.

  • It does not apply. A page type the rule exempts, or a rule that tests a signal your site has no reason to carry. The report says which.
  • The trade is deliberate. Blocking an AI crawler is a policy decision; a site that has made it on purpose should expect the points to fall and should not undo the policy to recover them.
  • The fix costs more than it buys. A rule weighted 2% that needs a week of work is not next after the 16% rule that needs an afternoon. The weights are published so this comparison can be made before the work.

How do I stop fixing the same thing twice?

Re-scan after the change and compare the failure list rather than the score. The score moves for several reasons at once; the list is the thing you edited.

If the fix was real, the rule disappears from the list and stays gone. If it was padding, it tends to come back the next time the page changes — which is the practical argument against padding, independent of anyone’s opinion about it.

Every rule is published at the check reference, one page each, with its weight and its stated limits; the arithmetic across all 40 is on the methodology page.

Questions about reading a failure

Should I fix every failed check?

No. Some rules do not apply to some page types, some are worth less than the edit costs, and one or two are deliberate trades. A failure is a claim about the page; whether to act on it is a decision with a price.

What is the fastest way to tell a real failure from an artefact?

Read the status and the evidence line. A non-200 status means the number describes the response; an evidence line that names what the scanner saw tells you whether the rule was applied to the thing you think it was.

Does a partial pass matter?

Sometimes. A partial pass is points left on the table, not a failure, and the arithmetic is published per rule. It matters when the missing points are cheap and not when the only way to get them is padding.

Evidence and sources

GEO can boost visibility by up to 40% overall in generative engine responses, and in the paper's Table 1 the best of the tested methods improve on the no-optimization baseline by 41% and 28%. — Generative Engine Optimization, KDD 2024

Every figure in this piece comes from the published study or from the rule set the scanner executes; both are linked, and both can be re-run.

Primary sources

Alex Xu — Maintainer, LLMention

I build and maintain LLMention: the scanner, the rule set and the study behind it. The work is published as source, so the method can be checked rather than taken on trust.

How this site is written and funded →

Read next