Skip to content

feat(site): publish llms.txt and llms-full.txt for agents that browse - #433

Merged
TMHSDigital merged 1 commit into
mainfrom
feat/llms-txt
Oct 5, 2026
Merged

TMHSDigital merged 1 commit into
mainfrom
feat/llms-txt

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

Closes #384.

Change

  • scripts/site/build_site.py: new write_llms_txt(), called after write_sitemap(). It writes two files.
  • Landing <head> gets <link rel="alternate" type="text/plain" href="llms.txt">. Because check_site_links.py resolves <link href>, the gate fails if the build ever stops writing the file.
  • .gitignore: both files are build outputs, like index.html and sitemap.xml. stage_public.py keeps them, since it only drops top-level .md files.

Evidence (local)

  • build_site.py → build_gallery.py → stage_public.py → check_site_links.py --root _site: 0 failures. The staged tree contains llms.txt (14.5 KB) and llms-full.txt (169 KB).
  • Falsified: deleting llms.txt from the staged tree makes the link gate report it missing.
  • Spot-checked lines: - [addon-scaffolding](https://raw.githubusercontent.com/…/skills/addon-scaffolding/SKILL.md): Scaffold a Blender add-on … and the rule line for prefer-temp-override-over-context-copy.

🤖 Generated with Claude Code

https://tmhsdigital.github.io/Blender-Developer-Tools/llms.txt returned
404. Agents that read docs from the web (Cursor @docs, web fetch) look
for it, and it lets an agent use the pack without installing a plugin.

The landing build now writes, next to sitemap.xml:
- llms.txt (llmstxt.org format): the site description, the install
  lines, and every skill and rule with its full description, each linked
  to the raw file on main; plus examples, snippets and templates;
- llms-full.txt: every SKILL.md body plus the generated rules summary.

The landing <head> links llms.txt, so the site link gate fails if the
build ever stops writing it. Both files are build outputs (gitignored),
like index.html and sitemap.xml.

Closes #384

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@TMHSDigital

Copy link
Copy Markdown
Owner Author

CI evidence before merge: all checks pass ( 13 pass ). Blender Smoke on PR head: Blender 5.2.2 LTS / Blender 4.5.14 LTS. Summaries (happy path; falsifiers) per leg: 143 passed, 1 skipped, 0 failed;143 passed, 0 skipped, 0 failed;141 passed, 3 skipped, 0 failed;136 passed, 7 skipped, 0 failed;

@TMHSDigital
TMHSDigital merged commit 93e9e8f into main Oct 5, 2026
13 checks passed
@TMHSDigital
TMHSDigital deleted the feat/llms-txt branch October 5, 2026 02:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

site: publish llms.txt (and llms-full.txt) so agents can fetch the pack index directly

1 participant