AgentSkillsCN

llms-txt-generator

通过扫描 apps/ 目录，检测文档结构的变化，进而更新 llmtxt-generator.py 脚本，仅新增缺失的部分，同时重新生成 llms.txt 与 llms-en.txt 文件。当您需要更新生成器、新增文档章节，或刷新 LLM 文本文件时，此方法将助您事半功倍。

SKILL.md
--- frontmatter
name: llms-txt-generator
description:
  Upgrade llmtxt-generator.py by scanning apps/ for doc structure changes, then
  regenerate llms.txt and llms-en.txt while only adding missing sections. Use
  when updating the generator, adding new doc sections, or refreshing LLM text
  files.

LLMs.txt Generator Upgrader

Goal

Upgrade llmtxt-generator.py using current app structure and existing apps/web/public/llms.txt, then regenerate outputs. Only add new or missing sections and links. Do not remove, rename, or rewrite existing sections unless the user explicitly asks.

Discovery: apps structure

  1. •Scan apps/ to understand doc surfaces and routing structure.
  2. •Note any new top-level doc categories or developer resources that are not represented in the current llms.txt.

Baseline: current llms.txt

  1. •Read apps/web/public/llms.txt.
  2. •Extract section headings (##) and link lists.
  3. •Treat this as the canonical baseline: preserve all existing sections and links, and avoid duplicates.

Update the generator (llmtxt-generator.py)

Always edit the generator, not the output files.

  • •Add only missing sections or links to CURATED_SECTIONS or ENGLISH_EXTRAS so the generator reproduces the current llms.txt plus any new additions.
  • •Keep descriptions short, factual, and consistent with the current style.
  • •Keep URL patterns canonical (no utm_ parameters).
  • •Keep LOCALES aligned with packages/i18n/src/config.ts and update LANGUAGE_NAMES for any newly added locale.
  • •If new routing patterns appear, update normalize_llms_urls() accordingly.

Regeneration

From the repo root:

code
python llmtxt-generator.py

Outputs:

  • •apps/web/public/llms.txt
  • •apps/web/public/llms-en.txt

Output constraints

  • •Only add new or missing sections/links; never delete existing ones.
  • •Preserve ordering unless a new section clearly belongs next to related ones.
  • •Do not fabricate llms-full.txt. Follow repo guidance or user instructions.
  • •For non-English locales, note the generator preserves existing content if the file exists; change this behavior only if explicitly requested.

Verification

  • •apps/web/public/llms.txt contains all prior sections and any new additions.
  • •Locale files exist for all configured locales.
  • •Output URLs are canonical and contain no utm_ parameters.

Example requests

  • •"Upgrade llmtxt-generator.py after a new docs section"
  • •"Add missing llms.txt sections based on apps structure"
  • •"Add a new locale and regenerate llms files"