We split this skill into the rules it gives an agent

31 rules. About 0 are common, 18 are distinctive, and 13 are very specific to this project.

• ≈0

  Common · estimate

  Many files like this have a rule of this kind.

• ≈18

  Distinctive · estimate

  This author's own choices. Worth a look.

• 13

  Very specific

  Tied to their project's names, files or tools. Probably skip.

• Common
• Distinctive
• Very specific

1. Very specific:

   Use rspress.config.ts and defineConfig from @rspress/core

   line 12
2. Very specific:

   Keep site-wide settings such as title, description, icon, logo, base, and lang in config instead of repeating them in page files

   line 14
3. Distinctive:

   Prefer first-class Rspress options before custom theme code or low-level bundler overrides

   line 15
4. Very specific:

   Keep custom theme code in a top-level theme/ directory and import original theme pieces from @rspress/core/theme-original

   line 16
5. Very specific:

   Use rspress dev for local development

   line 20
6. Very specific:

   Use rspress build for production output

   line 21
7. Very specific:

   Use rspress preview only for local preview of the built site

   line 22
8. Very specific:

   Use rspress eject only when CSS variables, class overrides, or layout wrapping cannot solve the customization

   line 23
9. Distinctive:

   Keep docs content under one clear docs root and group pages by topic or workflow, not by team ownership

   line 27
10. Very specific:

    Use _meta.json or _nav.json to control sidebar and navigation labels/order instead of encoding order in filenames

    line 28
11. Distinctive:

    Put reusable MDX snippets or shared components in shared files instead of duplicating them across pages

    line 29
12. Distinctive:

    Keep landing pages concise and link to deeper task-oriented guides from them

    line 30
13. Very specific:

    Add clear title and description frontmatter, and set sidebar, outline, navbar, or footer only when page defaults are not enough

    line 34
14. Very specific:

    Use pageType: home, doc, doc-wide, custom, or blank intentionally based on layout needs

    line 35
15. Distinctive:

    Write task-first headings and short intros.

    line 36
16. Distinctive:

    Prefer one topic per page and split overly long pages by workflow or feature area

    line 37
17. Distinctive:

    Keep code examples minimal, runnable, and version-accurate

    line 38
18. Distinctive:

    Use MDX for interactive docs and embedded components, but keep the main narrative understandable as plain markdown

    line 42
19. Distinctive:

    Prefer documented Rspress theme/runtime APIs over importing from internal source paths

    line 43
20. Distinctive:

    Prefer CSS variables for brand colors, spacing, and surface styling

    line 48
21. Very specific:

    Prefer BEM class overrides or Layout slots before ejecting built-in components

    line 49
22. Distinctive:

    Avoid full component ejection unless config, CSS, and wrapping cannot meet the requirement

    line 51
23. Distinctive:

    Keep descriptions and other frontmatter text in the same language as the page content

    line 56
24. Distinctive:

    Import source-managed images and components from docs/theme source when they belong to the content

    line 62
25. Very specific:

    Use public/ only for assets that must keep stable URL paths, such as favicons, social images, or download files

    line 63
26. Distinctive:

    Prefer official Rspress plugins for search, preview, and API-doc scenarios before building custom solutions

    line 68
27. Distinctive:

    Keep plugin usage explicit in config and remove unused plugins to reduce maintenance cost

    line 70
28. Very specific:

    Verify broken links, missing assets, and wrong base handling before deployment

    line 75
29. Distinctive:

    Keep generated output out of source control unless the hosting workflow explicitly requires committed artifacts

    line 76
30. Distinctive:

    When debugging content issues, inspect the resolved docs root, frontmatter, and theme overrides before assuming a bundler problem

    line 77
31. Distinctive:

    Use the config and API docs when checking exact option names or current behavior

    line 82

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

• Other versions2 projects use a version of this.

  Word for word · 0

  None found.

  Edited · 2

  1. open-spaced-repetition/ts-fsrs★ 84695% same
  2. Muromi-Rikka/cc-learn★ 295% same

  Wrote their own version · 0

  None found.

  How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

• In this repository31 other files it gives its agents.

  • AGENTS.mdAGENTS.md
  • create-draft-release-notesSkill
  • mdx-to-markdownSkill
  • pr-creatorSkill
  • release-blog-writerSkill
  • rstack-docs-writerSkill
  • rstack-eco-ci-debugSkill
  • rstack-repo-maintainSkill
  • rstack-skill-evaluatorSkill
  • migrate-to-rsbuildSkill
  • migrate-to-rslibSkill
  • migrate-to-rslintSkill
  • migrate-to-rstestSkill
  • rsbuild-best-practicesSkill
  • rsbuild-v2-upgradeSkill
  • rsdoctor-analysisSkill
  • rsdoctor-v2-upgradeSkill
  • rslib-best-practicesSkill
  • rslib-modern-packageSkill
  • rspack-best-practicesSkill
  • rspack-debuggingSkill
  • rspack-split-chunksSkill
  • rspack-tracingSkill
  • rspack-v2-upgradeSkill
  • rspress-custom-themeSkill
  • rspress-description-generatorSkill
  • rspress-docs-generatorSkill
  • rspress-v2-upgradeSkill
  • rstest-best-practicesSkill
  • rstest-debuggingSkill
  • storybook-rsbuildSkill