Resource
Fix Invalid JSON from AI
The JSON won't parse and you can't see why. Deterministic cause-sniffing — trailing commas, single quotes, unclosed brackets — and the repair prompt that fixes it.
Validate Markdown Structure
Heading scan against the skeleton: missing sections, broken order, absent title — the README that shipped without its Examples.
Overview
Generated documents erode structurally: a section gets dropped, another swaps position, and the document still looks fine at a glance. This setup validates a README against its five-section skeleton and catches the two most common drops — Installation and Examples, the sections readers actually came for. The heading scan is real markdown parsing of #/##/### lines with order checking; the repair prompt restores the missing sections without touching the ones that survived.
How to use this resource
-
Paste skeleton and document
The expected sections in order; the generated markdown raw — heading scan does the rest.
-
Read the missing-section fails
Installation and Examples are the sections users need most — and the ones models drop first.
-
Repair into the same document
The repair prompt adds what's missing and keeps every surviving section verbatim.
Why This Works
- A heading scan beats eyeballing for documents over a screen long
- Order checking catches restructuring that presence checks miss
- Severity weighting puts dropped sections above cosmetic issues
Best for
- Doc generation pipelines with fixed skeletons
- Repos generating READMEs at scale
- Anyone whose generated docs "look complete"
Not for
- Defining the document skeleton — that's the Markdown Output Builder
- Reviewing the prose quality — structure validation, not editing
Use cases
- Checking generated READMEs kept all five sections
- Verifying docs pages before they merge
- Catching the dropped section a reviewer would miss
FAQ
How does this catch a section that quietly got dropped from a generated README?
The AI Output Validator does a real heading scan of the #/##/### lines and checks them against the expected skeleton in order — in the loaded example it flags "Missing section: Installation" and "Missing section: Examples," the two sections readers came for. Order checking also catches a section that swapped position. It surfaces structural gaps; it doesn't review the prose quality, and it can't guarantee catching every content problem.
Will fixing the missing sections rewrite the parts that were already fine?
Surviving sections stay untouched: the REPAIR TASK returns only the corrected markdown under the rules "Keep everything that was already correct unchanged" and "Fix only the problems listed above," so untouched sections travel verbatim while Installation and Examples get restored. You run that repair prompt in your own assistant; the validator produces it but doesn't regenerate the document itself.
More resources from AI Output Validator
Resource
Validate AI Output — Catch Format Violations
Paste the response, get the verdict: real JSON parsing, missing-field detection, and a repair prompt for everything found.
Resource
Agent Evaluation Scorecard Prompt
Grade agent output the same way every time — a rubric scoring correctness, grounding, safety, tone, and completeness, with a pass threshold instead of a gut call.
Resources that pair well
Resource
Force JSON Output from AI
Stop getting 'Sure, here is the JSON…' — the output-contract pattern that forces models to return only parseable JSON: schema, example, and a strict rule block.
Resource
Extract Data From Text with AI
Free text in, named fields out. The extraction prompt pattern that turns any unstructured text into consistent, parseable records.
Resource
Classify Support Tickets with AI
Billing, Technical, Account, How-To, Feature Request — ticket triage with definitions that decide the borderline cases for the model.
Related tools
Tool
AI Output Validator
Paste an AI's output and validate it against the expected format — with a repair prompt for every failure found.
Workflows that use this resource
Workflow
AI Content Writing Workflow
Turn source material and a target audience into clear docs, help, or knowledge-base content — gather the material, outline the piece, write it section by section, then check it for clarity and gaps.
Workflow
AI Code Documentation Workflow
Generate documentation that matches the code instead of drifting from it — have AI explain what the code really does, write it up as structured docs, then validate the format holds.
Guides for this resource
Guide
How to Write a README With AI From Your Project Facts
Your README works perfectly on the one machine where the tool was already installed. Everyone else hits a missing prerequisite in the first ninety seconds. Here's how to build a README from your real setup facts — and the clean-machine run that decides whether any of it is true.