# Daymoon: AI readiness checker for documentation

> Daymoon checks whether ChatGPT, Claude and other AI tools can read a documentation site, and says what to fix first. Free, no sign-up.

Use it at https://daymoon.labs.clickhelp.com/. Each report gets its own link, and every report page is also available as Markdown: add .md to its address.

## How a check works

1. You paste the address of a documentation site.
2. Daymoon reads its llms.txt, if there is one, and picks up to 15 pages to test.
3. It runs 14 checks, using the open-source [afdocs](https://www.npmjs.com/package/afdocs) library.
4. The report lists what to fix first and shows each check next to the same check on docs.clickhelp.com.

The headline is a count, such as "11 of 14 checks passed". A check that couldn't run never counts as passed.

## What it checks

### llms.txt

- **llms.txt.** llms.txt is a short index that tells AI tools what your docs cover and where to start reading. Without it, they have to guess from whatever pages they land on.
- **llms.txt format.** AI tools expect a title, a one-line summary and sections with lists of links. With a different layout, they may miss the links.
- **llms.txt length.** Many AI tools read only the first part of a long file, so links near the end of a very long llms.txt may never be read. This check aims for under 50,000 characters.
- **llms.txt points to Markdown.** When llms.txt points to Markdown copies, AI tools get clean text straight away instead of parsing HTML.

### Markdown copies

- **Markdown versions of pages.** AI tools read clean Markdown far more reliably than HTML. A common convention is that adding .md to a page URL returns the page as plain text.
- **Code blocks in Markdown.** An unclosed ``` block turns the rest of the page into code, and AI tools misread everything after it.

### Page size and layout

- **Text without JavaScript.** Most AI tools don't run JavaScript. If the text is added by scripts, they see an empty page.
- **Markdown page length.** AI tools read a limited amount of text at once, and some cut a long page off before the end. This check aims for under 50,000 characters per page.
- **Content vs. page weight.** AI tools strip the tags, scripts and styles, but they still have to download them, and very large pages can get cut off before the text.
- **HTML size.** AI tools download and unpack the whole HTML page before reading it. Heavy pages are slow to process, and some tools give up. This check aims for under 1 MB, measured after decompression.
- **Where the content starts.** AI tools often read a page from the top and cut it off when it gets long. If menus and sidebars come first, the actual answer may never be read.
- **Whole page in one request.** AI tools usually fetch a page once. If the content is split across several requests, they only see the first part.

### How the site answers

- **Redirects.** Each redirect is one more request. Long chains or redirects in JavaScript can stop an AI tool before it reaches the page.
- **Open access.** AI tools can't log in. Pages behind a login are invisible to them.

## What a check can't tell you

- It tests a sample of up to 15 pages, not the whole site.
- It looks at how AI tools can fetch and read the pages, not whether the text itself is correct or complete.
- It reads public pages only. Docs behind a login are reported as closed.
- A report is a snapshot: it shows the site as it was when checked.

## Example

- [Report on docs.clickhelp.com](https://daymoon.labs.clickhelp.com/r/8agNkPxvn8.md)

Daymoon is made by [ClickHelp](https://clickhelp.com).