Citability¶
Citability measures whether agents can extract and quote specific, verifiable claims from this service's content.
What it measures¶
Scoring Citability against Dimension 2 of the agent-readiness-rubric; generating FIX artifacts from fix-templates/; flagging any ESCALATE items.
How it scores¶
| Score | Descriptor |
|---|---|
| 0–4 | Content is vague, promotional, or cannot be quoted as a factual claim. "The best tool for your business" is not citable. |
| 5–9 | Some specific claims present but mixed with filler copy. Hard to extract a citable unit without reading full paragraphs. |
| 10–14 | Most key pages have at least one citable claim (stat, price, specification, named process). Some pages still marketing-led. |
| 15–19 | Content structured for citation. Headers act as claim labels. Stats are sourced. Definitions are precise. |
| 20 | Every key page opens with or contains a quotable, verifiable claim agents can confidently extract and attribute. |
What it generates on FIX¶
All of these produce a text artifact the operator can write:
- Rewritten opening lede (Answer Capsule) — from
fix-templates/answer-capsule.md. Replaces a marketing-led opening with a specific, verifiable 40–60 word claim that agents can extract and cite verbatim. Applied to every key page that opens with promotional language. - FAQ block (HTML + schema) — from
fix-templates/faq-block.mdpaired withfix-templates/jsonld-faqpage.md. Generates 5–7 discrete Q&A pairs, each a separate citation opportunity. The two artifacts are always generated together — visible HTML and schema must stay in sync. - Comparison table — generated inline (no dedicated template). Used when key offerings or specifications need to be placed in a scannable, extractable format. Markdown table rendered as an HTML
<table>with clear column headers. - Answer Capsule for section headers — additional capsules applied to section openings on service/product pages where the lede is buried.
What escalates¶
If a page makes claims that require a missing fact to be credible (e.g., a cited statistic whose source is not on the page), the missing value is flagged precisely rather than leaving a placeholder or fabricating a citation.