# Cal.com

[cal.com/docs](https://cal.com/docs)

- **Overall score:** 89/100 (Grade B)
- **Checks passed:** 19 / 29
- **Last computed:** 2026-04-29

## Components

### Content Discoverability

- **Score:** 87/100 · **Status:** partial
- **Summary:** 4 warnings across 6 AFDocs checks.
- **Rationale:** Agents need a clear entry point and crawl map before they can reliably discover the right pages.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **LLMS TXT Exists** — llms.txt found at 2 location(s)
- ⚠️ **LLMS TXT Valid** — llms.txt contains parseable links but doesn't fully follow the proposed structure: https://cal.com/docs/llms.txt: No blockquote summary found; https://cal.com/llms.txt: No blockquote summary found Your llms.txt contains parseable links but doesn't follow the standard structure. Add an H1 title as the first line and a blockquote summary (lines starting with >) to improve agent parsing.
- ⚠️ **LLMS TXT Size** — llms.txt is 92,262 characters (between 50,000 and 100,000; consider splitting) Your llms.txt is 92,262 characters, which may be truncated on some agent platforms. If it grows further, split into nested llms.txt files with a root index under 50,000 characters.
- ⚠️ **LLMS TXT Links Resolve** — 14/15 same-origin sampled links resolve (93%); 1 broken 1 of 15 links in your llms.txt return errors. Audit and fix or remove broken URLs to prevent agents from hitting dead ends.
- ✅ **LLMS TXT Links Markdown** — 15/15 same-origin sampled links point to markdown content (100%)
- ⚠️ **LLMS TXT Directive** — llms.txt directive found in 14 of 15 sampled pages (1 missing) An llms.txt directive was found on some pages but is missing from others, or is buried deep in the page. Ensure the directive appears near the top of every documentation page.

### Markdown Availability

- **Score:** 98/100 · **Status:** pass
- **Summary:** 2 AFDocs checks pass.
- **Rationale:** When markdown is available directly, agents spend less effort stripping presentation markup and guessing structure.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Markdown Url Support** — 15/15 sampled pages support .md URLs (100%)
- ✅ **Content Negotiation** — 14/15 sampled pages support content negotiation (93%)

### Page Size and Truncation Risk

- **Score:** 76/100 · **Status:** fail
- **Summary:** 1 failed across 4 AFDocs checks.
- **Rationale:** Large pages and delayed primary content increase truncation risk and make retrieval less reliable.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Rendering Strategy** — All 15 sampled pages contain server-rendered content
- ✅ **Page Size Markdown** — All 15 pages under 50K chars (median 4K, max 27K)
- ❌ **Page Size Html** — 14 of 15 sampled pages convert to over 100K chars (max 700K, 23% boilerplate) 14 of 15 pages convert to over 100K characters of markdown. Reduce inline CSS/JS, break large pages, or provide markdown versions as a smaller alternative.
- ✅ **Content Start Position** — Content starts within first 10% on all 15 sampled pages (median 3%)

### Content Structure

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 3 AFDocs checks.
- **Rationale:** Predictable sections, valid code fences, and serialized tabs make the content easier for agents to parse correctly.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Tabbed Content Serialization** — 25 tab group(s) across 12 of 15 sampled pages; all serialize under 50K chars
- ⏭️ **Section Header Quality** — 12 page(s) with tabs found, but no section headers inside tab panels to evaluate
- ✅ **Markdown Code Fence Validity** — All 39 code fences properly closed across 17 pages

### URL Stability and Redirects

- **Score:** 99/100 · **Status:** partial
- **Summary:** 1 warning across 2 AFDocs checks.
- **Rationale:** Stable URLs and sane redirect behavior prevent retrieval drift and broken tool references.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Http Status Codes** — All 15 sampled pages return proper error codes for bad URLs
- ⚠️ **Redirect Behavior** — 1 of 15 sampled pages use cross-host redirects 1 pages use cross-host HTTP redirects, which some agents don't follow. Where possible, use same-host redirects or update URLs to point directly to the final destination.

### Observability and Content Health

- **Score:** 96/100 · **Status:** fail
- **Summary:** 1 failed across 3 AFDocs checks.
- **Rationale:** Coverage, parity, and cache behavior determine whether agents can trust the content they retrieve.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **LLMS TXT Freshness** — llms.txt covers 100% of 383 sitemap doc pages; 3 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
- ❌ **Markdown Content Parity** — 1 of 15 pages have substantive content differences between markdown and HTML (avg 4% missing) 1 pages have substantive content differences between markdown and HTML (avg 4% missing). Agents receiving the markdown version are getting outdated or incomplete content. Regenerate markdown from source or fix the build pipeline.
- ✅ **Cache Header Hygiene** — All 17 endpoints have appropriate cache headers

### Authentication and Access

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 2 AFDocs checks.
- **Rationale:** Agents need either public access or a clear alternative path when documentation is gated behind auth.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Auth Gate Detection** — All 15 sampled pages are publicly accessible
- ⏭️ **Auth Alternative Access** — All docs pages are publicly accessible; no alternative access paths needed

### Full Content Discoverability

- **Score:** 75/100 · **Status:** fail
- **Summary:** llms-full.txt has 1 failing check.
- **Rationale:** A full-document snapshot gives long-context agents a single canonical corpus to ingest without repeated crawling.
- **Reference:** [llms-full.txt guide](https://www.mintlify.com/docs/ai/llmstxt#llms-full-txt)

**Checks**

- ✅ **LLMS Full Exists** — Found llms-full.txt.
- ✅ **LLMS Full Size** — llms-full.txt size is within the expected range.
- ✅ **LLMS Full Valid** — llms-full.txt has a recognizable markdown structure.
- ❌ **LLMS Full Links Resolve** — Some llms-full.txt links do not resolve successfully.

### Agent Skills

- **Score:** 100/100 · **Status:** pass
- **Summary:** skill.md passes all checks.
- **Rationale:** Agent skills provide product-specific operating guidance that plain documentation pages do not encode on their own.
- **Reference:** [skill.md guide](https://www.mintlify.com/docs/ai/skillmd)

**Checks**

- ✅ **Skill MD** — Found an agent skill definition.

### MCP Server

- **Score:** 100/100 · **Status:** pass
- **Summary:** MCP passes all checks.
- **Rationale:** A discoverable MCP server lets agents use first-class tools instead of scraping pages and inferring behavior.
- **Reference:** [MCP guide](https://www.mintlify.com/docs/ai/model-context-protocol)

**Checks**

- ✅ **MCP Server Discoverable** — Found an MCP server.
- ✅ **MCP Tool Count** — The MCP server exposes tools.