Create and update Abacus MDX documentation pages with frontmatter and build validation.
npx skills add https://github.com/getsentry/abacus --skill write-docs-getsentry
Please help me install this Agent Skill. Skill: write-docs Source: https://github.com/getsentry/abacus/tree/main/.claude/skills/write-docs Command: npx skills add https://github.com/getsentry/abacus --skill write-docs-getsentry
This skill automates the creation and maintenance of Abacus documentation pages, ensuring consistency with Astro Starlight patterns and keeping documentation in sync with code changes.
Use the write-docs skill to add or update a docs page by creating an MDX file in docs/src/content/docs, ensure frontmatter is present with title, description, and sidebar order, then run the docs build locally with 'cd docs && pnpm build'.
High-intent search queries and answers about installing and using this skill.
MDX documentation pages require frontmatter with title, description, and sidebar order defined in the file header. This ensures consistency across the docs site and proper integration with the Astro Starlight build workflow.
Validate an Astro Starlight docs build locally by running 'cd docs && pnpm build'. This pipeline checks for broken links, misconfigurations, and frontmatter issues before deploying documentation updates.
Keeping documentation in sync with code changes involves updating existing MDX pages to reflect API updates or deployment notes. Automating this maintenance ensures docs stay accurate and aligned with the current codebase.
Yes, pnpm is required to build the docs site. The Astro/Starlight build workflow validates documentation by running the build pipeline with pnpm in the docs directory to catch configuration errors.
A docs build fails when new MDX pages lack required frontmatter fields like title, description, or sidebar order. Missing frontmatter breaks Astro Starlight patterns and causes pipeline validation errors during the build.
cybersaderBuild and configure the Crosswalker documentation site using Astro Starlight.
githubnextGenerate Diátaxis documentation with Astro Starlight MDX components and frontmatter metadata.
dthompsonflEnforce frontmatter standards and semantic structure for MDX content.
shinnytechRefine product ideas into detailed design specifications through structured questioning.
