Add llms.txt files, an AI docs page, and agent skills - #42770
Merged
Conversation
Generate /llms.txt (a curated, llmstxt.org-style index of the docs) and /llms-full.txt (the full docs text concatenated for ingestion) from the sidebar and docs content, and link both from the install page.
Pull in the getting-started/llms page, the bundler/install agent skills (bootstrap-v6-install, -npm, -webpack, -parcel, -vite), guide callouts linking each skill, and the eslint allowance for skill code blocks.
Rename the getting-started page to /getting-started/ai (ai.mdx) and its sidebar entry to AI. Generate the skills table from each SKILL.md frontmatter via a new skills lib and SkillsTable shortcode, adding a guide key to every skill so the table never drifts from the files. Standardize skill customization on CSS-token overrides ($root-tokens and $*-tokens), matching the Customize › Sass docs, and note that token names are authored unprefixed (PostCSS adds the --bs- prefix). Rename workflow 'Phase' to 'Step' throughout, add SRI integrity placeholders to the CDN snippet, and fix the Vite file-tree box drawing.
Agents had guidance for installing Bootstrap and moving off v5, but nothing for everyday work, so add skills for authoring a component and its JavaScript, customizing the color system, and generating utilities. A v4-to-v6 skill covers projects skipping v5 entirely, and the v5-to-v6 skill now points there and fixes its layer list and `$radius` example.
The skill still described the pre-rebase toolchain: JS sources in js/src, a js/index.js barrel, Karma, and Jasmine specs. Rewrite it against what is on v6-dev now — TypeScript sources with the config/field/override conventions the compiler options force, the js/src/index.ts barrel, the type tests that guard the shipped declarations, and Vitest browser mode with its Jasmine shim. TypeScript code blocks in markdown need a parser, so point ESLint at the TypeScript one for them; the blocks are checked for syntax only.
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
1 participant
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.
Bootstrap ships no machine-readable documentation and no guidance for coding agents, so AI tools either scrape the site or guess at v6 APIs — and they guess wrong, since v6 renamed components, moved customization to CSS token maps, and dropped jQuery.
This adds two generated routes:
/llms.txtas a curated index of every docs page, and/llms-full.txtas the concatenated page bodies for direct ingestion. Both are built by traversingsite/data/sidebar.yml, so they inherit the same ordering and inclusion rules as the site nav. A new Getting started > AI page documents them.It also adds eleven agent skills under
skills/, each aSKILL.mdplaybook: setup (install, npm, Webpack, Parcel, Vite), migration (v4-to-v6 and v5-to-v6), and authoring (component CSS, component JavaScript, the color system, and the utility API). Frontmatter on each skill names the human guide it pairs with, and the table on the AI page is generated from that frontmatter so the two cannot drift apart.Supersedes #42728, which carried only the
llms.txtroutes.