docs(skills): use bundled llms index

Author: chenjiahan

.agents/skills/rstack-cli-best-practices/SKILL.md

@@ -11,37 +11,14 @@ Before any Rstack work, find and read the relevant Markdown documentation shippe
 installed `rstack` package. Model knowledge and summaries in this skill can be outdated; the
 installed documentation is the source of truth for the project's Rstack version.
 
-1. Read only the pages relevant to the task under `node_modules/rstack/dist/docs` before proposing
-   or making changes.
+1. Start with `node_modules/rstack/dist/docs/llms.txt`, then read only the linked pages relevant to
+   the task before proposing or making changes.
 
-2. If the correct page is unclear, start with the documentation index and search the documentation
-   root with `rg -n "<keyword>" <docs-root>`.
+2. If `llms.txt` is unavailable, start with `node_modules/rstack/dist/docs/index.md` and search the
+   documentation directory with `rg -n "<keyword>" node_modules/rstack/dist/docs`.
 
 3. For exact CLI flags and behavior, also run `rs -h` or `rs <command> -h` when supported.
 
 If the bundled docs are not available at that path, locate the installed `rstack` package. If they
 are still unavailable, verify that `rstack` is installed, report the installed version, and use CLI
 help plus the online Rstack documentation as a fallback. Do not guess from model memory.
-
-## Documentation map
-
-These links target the usual project-local skill installation. If a link does not resolve, open
-the same relative path under the resolved documentation root.
-
-- [Overview](../../../node_modules/rstack/dist/docs/index.md)
-- [Quick start and command overview](../../../node_modules/rstack/dist/docs/guide/quick-start.md)
-- [Configuration](../../../node_modules/rstack/dist/docs/guide/configuration.md)
-- [API and import paths](../../../node_modules/rstack/dist/docs/guide/api-reference.md)
-- [Monorepos](../../../node_modules/rstack/dist/docs/guide/monorepo.md)
-- [Testing](../../../node_modules/rstack/dist/docs/guide/testing.md)
-- [Formatting](../../../node_modules/rstack/dist/docs/guide/formatting.md)
-- CLI commands: [dev](../../../node_modules/rstack/dist/docs/guide/cli/dev.md),
-  [build](../../../node_modules/rstack/dist/docs/guide/cli/build.md),
-  [preview](../../../node_modules/rstack/dist/docs/guide/cli/preview.md),
-  [lib](../../../node_modules/rstack/dist/docs/guide/cli/lib.md),
-  [doc](../../../node_modules/rstack/dist/docs/guide/cli/doc.md),
-  [test](../../../node_modules/rstack/dist/docs/guide/cli/test.md),
-  [lint](../../../node_modules/rstack/dist/docs/guide/cli/lint.md),
-  [fmt](../../../node_modules/rstack/dist/docs/guide/cli/fmt.md),
-  [setup](../../../node_modules/rstack/dist/docs/guide/cli/setup.md), and
-  [staged](../../../node_modules/rstack/dist/docs/guide/cli/staged.md)

scripts/prepare-release.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawn } from 'node:child_process';
-import { copyFile, mkdir, readdir, rm } from 'node:fs/promises';
+import { copyFile, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 
 const rootDir = path.resolve(import.meta.dirname, '..');
@@ -71,4 +71,10 @@ for (const relativePath of markdownFiles) {
   await copyFile(path.join(websiteDistDir, relativePath), destination);
 }
 
-console.log(`Copied ${markdownFiles.length} English Markdown files to ${packageDocsDir}.`);
+const llmsTxt = await readFile(path.join(websiteDistDir, 'llms.txt'), 'utf8');
+const packageLlmsTxt = llmsTxt.replace(/\]\(\/(?!\/)/g, '](./');
+await writeFile(path.join(packageDocsDir, 'llms.txt'), packageLlmsTxt);
+
+console.log(
+  `Copied ${markdownFiles.length} English Markdown files and llms.txt to ${packageDocsDir}.`,
+);