skills.rest
wyattowalsh
wyattowalshCOMMUNITY
Explore all skills by this author →
Website𝕏@wyattowalshGitHub

docs-steward

Syncs generated MDX pages from SKILL.md and agent.md files into Astro Starlight documentation sites.

4|1|Updated Jan 26, 2026
Search Tags:#automation#documentation#content generation#maintenance#astro#docs-as-code#starlight
One-click install
npx skills add https://github.com/wyattowalsh/agents --skill docs-steward-wyattowalsh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docs-steward
Source: https://github.com/wyattowalsh/agents/tree/main/.claude/skills/docs-steward
Command: npx skills add https://github.com/wyattowalsh/agents --skill docs-steward-wyattowalsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wagents, pnpm, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures your documentation site stays up-to-date, accurate, and user-friendly by automating the process of regenerating, enhancing, and verifying documentation pages.

Core Features & Use Cases

  • Automated Syncing: Regenerates documentation pages whenever skills, agents, or MCP servers change.
  • Content Enhancement: Improves descriptions, adds usage examples, and incorporates Starlight components for better readability.
  • Health Checks: Validates links, detects stale or orphaned pages, and checks build status.
  • Use Case: After adding a new skill or updating an agent's configuration, this Skill automatically updates the corresponding documentation, ensuring users always have the latest information.

Quick Start

Run the docs-steward skill to automatically sync and enhance documentation after asset changes.

Frequently Asked Questions about docs-steward

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate documentation regeneration for an Astro and Starlight site?▼

Automate documentation regeneration by syncing generated MDX pages from source assets like SKILL.md and agent.md files. This process updates corresponding documentation pages automatically whenever underlying skills, agents, or MCP server configurations change.

How do I keep documentation fresh and accurate after updating agent configurations?▼

Keep documentation fresh by running automated health checks that validate links, detect stale or orphaned pages, and verify build status. Content enhancement also improves descriptions and adds usage examples to ensure accuracy.

Can I use AI to enhance descriptions and usage examples in my docs-as-code workflow?▼

Yes, AI-powered content enhancement improves descriptions, adds usage examples, and incorporates Starlight components for better readability. This ensures your docs-as-code workflow generates engaging and user-friendly documentation.

Do I need the wagents CLI and pnpm to sync generated MDX pages?▼

Yes, you need the wagents CLI and pnpm to sync generated MDX pages and execute build processes. These dependencies are required to automate content regeneration, run health checks, and verify build status.

What is the best way to validate links and detect stale pages in a Starlight documentation site?▼

The best way to validate links and detect stale or orphaned pages is through comprehensive health checks. These checks also verify build status, ensuring your Starlight documentation site remains accurate and fully functional.

Related Skills

Explore More Software Engineering Skills→
baiciebaicie
2

pnpm

Manage Node.js dependencies and monorepo workspaces using pnpm.

Community
Advanced
getsentrygetsentry
78

write-docs

Create and update Abacus MDX documentation pages with frontmatter and build validation.

Official
Intermediate
githubnextgithubnext
4.9k

documentation

Generate Diátaxis documentation with Astro Starlight MDX components and frontmatter metadata.

Official
Basic
georgekhananaevgeorgekhananaev
27

md

Enforce consistent Markdown syntax across documentation and README files.

Community
Basic