Repository navigation
feat(site): publish llms.txt and llms-full.txt for agents that browse - #433
Merged
Merged
Conversation
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>
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; |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #384.
Change
scripts/site/build_site.py: newwrite_llms_txt(), called afterwrite_sitemap(). It writes two files.llms.txt(llmstxt.org shape) contains:site.jsondescription);## Skills(16) and## Rules(9), each linked to the raw file onmainwith its full frontmatter description. These now carry the "Use when…" triggers from skills: descriptions have no 'Use when…' trigger phrasing, which hurts auto-selection in Claude Code and Cursor #357;## Examplesand## Optional(snippets, templates, the Claude rules summary).llms-full.txt: everySKILL.mdbody plusclaude/blender-rules.md. That's about 169 KB, for agents that want the whole pack in one fetch.<head>gets<link rel="alternate" type="text/plain" href="llms.txt">. Becausecheck_site_links.pyresolves<link href>, the gate fails if the build ever stops writing the file..gitignore: both files are build outputs, likeindex.htmlandsitemap.xml.stage_public.pykeeps them, since it only drops top-level.mdfiles.Evidence (local)
build_site.py→build_gallery.py→stage_public.py→check_site_links.py --root _site: 0 failures. The staged tree containsllms.txt(14.5 KB) andllms-full.txt(169 KB).llms.txtfrom the staged tree makes the link gate report it missing.- [addon-scaffolding](https://raw.githubusercontent.com/…/skills/addon-scaffolding/SKILL.md): Scaffold a Blender add-on …and the rule line forprefer-temp-override-over-context-copy.🤖 Generated with Claude Code