In short:
ak-llmspicks your public docs pages, summarizes each one, groups them and writesllms.txtper the llmstxt.org spec, plusllms-full.txtwhen you need the full text. It also sets the convention for each page's.mdcopy. It does not configure your site to serve these files: that belongs to your site's framework skill, for exampleak-web-frameworksfor Next.js.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you have a docs site and want AI to read it cleanly and correctly, without chewing through HTML. The input can be the project's README and docs menu, a folder, or just a URL. You do not need it when you only want to set up routes, a sitemap or robots.txt for your site.
flowchart LR
A["README, docs menu, or docs URL"] --> B["ak-llms"]
B --> C["llms.txt"]
B --> D["llms-full.txt with --full"]
B --> E["Convention for each page's .md copy"]
C --> F["Site framework skill serves the files, e.g. ak-web-frameworks"]
E --> FFour things to know:
| Concept | Question | Example |
|---|---|---|
| Public sources | Which pages go into the files AI reads? | The README and pages in the docs menu go in. Drafts, internal config and secrets stay out. |
| llms.txt and llms-full.txt | Does AI need a short index or the whole content? | llms.txt is an index: project name, a short summary, then groups of links with one-line descriptions. llms-full.txt copies every page's content into one file. |
| Each page's .md copy | Do links in llms.txt point to the HTML page or a Markdown copy? | The page /docs/intro has a copy at /docs/intro.md. A page whose URL ends in / gets index.html.md. |
| The Optional section | Which pages may AI skip when context is tight? | FAQ, changelog and migration guides sit in an ## Optional group at the end of the file. |
The main trade-off: llms.txt is compact but AI has to open each link, while llms-full.txt has everything but weighs heavy on context when the docs are large.
Sample prompt for a docs site index:
/ak-llms --base-url https://<domain>/docs
Only take pages in the docs menu and the README.
Leave out: drafts, internal docs.| Flag | What it is for | Since ak |
|---|---|---|
--full | Adds the full-text file llms-full.txt | 1.0.0 |
--md-links | Links to each page's .md copy instead of HTML | 2.19.0 |
--output | Picks where the files are written | 1.0.0 |
--trailing-slash | Site uses a trailing / for folder pages | 2.19.0 |
--base-url | Base URL for every link | 2.19.0 |
Below is the detailed version: the run flow, 4 situations with prompts, each flag explained, the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-llms: build llms.txt and Markdown copies of your docs" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-llms". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-llms
