Validates Nx documentation pages against the astro-docs style guide and information architecture rules.
npx skills add https://github.com/nrwl/nx --skill check-docs-style
Please help me install this Agent Skill. Skill: check-docs-style Source: https://github.com/nrwl/nx/tree/main/.claude/skills/check-docs-style Command: npx skills add https://github.com/nrwl/nx --skill check-docs-style
Documentation edits in the Nx repo often drift from the astro-docs style guide and sidebar information architecture, requiring manual review cycles to catch style violations and misplaced pages.
nx run astro-docs:vale and fixes errors and unambiguous warnings directly in modified .mdoc, .mdx, and .md files.Check the style and information architecture of the docs pages I just modified in astro-docs.
High-intent search queries and answers about installing and using this skill.
Run this skill after editing docs files in astro-docs/src/content. It executes `nx run astro-docs:vale` for mechanical rules, then manually checks your changed text against every rule in STYLE_GUIDE.md and fixes violations.
The skill audits page placement against seven information architecture principles, including progressive disclosure, category homogeneity, and the pen-and-paper test, using astro-docs/sidebar.mts to evaluate sibling pages.
No. Vale enforces only a subset of mechanical rules, so a clean Vale run does not mean the guide passed. The skill performs an additional manual rule-by-rule pass over your changed text to catch what Vale misses.
Use inline Vale comments like `<!-- vale Nx.Headings = NO -->` around legitimate exceptions such as camelCase CLI option headings. Prefer wrapping headings in backticks first, and never suppress rules just to avoid real fixes.
It triggers automatically whenever .mdoc, .mdx, or .md files under astro-docs/src/content are created or modified, without needing to be asked, and also responds to phrases like check style or validate docs.
Grupo-AFALUpdate Astro Starlight MDX docs and sidebar from changed source files.
Grupo-AFALScaffold an Astro Starlight documentation site into a Rails application.
ovachieverVerify documentation claims about toolhive and generate structured findings.
facebookRun yarn prettier and yarn linc to fix linting and formatting issues.