Skip to content

feat(rspress-generate-docs): add skill for generating and maintaining rspress docs#75

Draft
SoonIter wants to merge 4 commits into
mainfrom
feat/rspress-generate-docs-skill
Draft

feat(rspress-generate-docs): add skill for generating and maintaining rspress docs#75
SoonIter wants to merge 4 commits into
mainfrom
feat/rspress-generate-docs-skill

Conversation

@SoonIter

Copy link
Copy Markdown
Member

Summary

Add a new rspress-generate-docs skill that helps generate and maintain Rspress documentation for projects.

What's included

  • skills/rspress-generate-docs/SKILL.md — high-level workflow for inspecting a project and choosing the right docs path.
  • references/create-new-docs.md — scaffold a Rspress v2 docs site from an undocumented project, including Rslib integration and package-manager-aware setup.
  • references/maintain-docs-for-prs.md — update an existing Rspress v2 docs site based on PR descriptions, linked issues, or branch diffs.
  • references/migrate-rspress-v1.md — migrate an existing Rspress v1 docs site to v2 via the official migration guide.
  • references/doc-structure-conventions.md — concrete _nav.json / _meta.json examples for Guide/API sites, grouped sections, and i18n layouts.
  • README.md — register the new skill in the skills list.

Scope note

Evals (skills/rspress-generate-docs/evals/evals.json) are intentionally excluded from this PR and will be added separately.

Checklist

  • Skill frontmatter and description added
  • Core workflow documented
  • Reference files split by path/variant
  • README updated

SoonIter added 3 commits June 15, 2026 19:05
… Rspress v2 docs

- Add SKILL.md with workflow for creating new docs, maintaining docs for PRs,
  and migrating Rspress v1 to v2.
- Add reference docs covering project scaffolding (including getting-started
  link, templates, Node version, and Rslib integration), PR-driven updates,
  v1→v2 migration, and doc structure conventions with _nav.json/_meta.json.
- Add evals/evals.json with test prompts for the three workflows.
- Register the skill in README.md.
- Rename skill directory and update SKILL.md frontmatter/title.
- Update README.md skill list and move rspress-docs-generator to the top
  of the Rspress Skills section.
- Update evals/evals.json skill_name and fixture_root paths.
- Rename local workspace directory for consistency.
@SoonIter SoonIter force-pushed the feat/rspress-generate-docs-skill branch from b6dc486 to 92b02d0 Compare June 15, 2026 11:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant