docs-automation

name	docs-automation
description	Automate docs updates and command documentation generation. Use for generate-command-docs, enhance-command-docs, sidebar generation, and VitePress build checks.
argument-hint	Doc scope + intent (e.g., update command docs for data-sync, regenerate sidebar)
user-invocable	true

Docs Automation Skill

Use this skill for documentation generation and maintenance tasks.

When to Use

• Regenerating command documentation in docs/02-commands/
• Enhancing command docs after generation
• Updating or regenerating the VitePress sidebar
• Validating doc builds and link consistency

Procedure

1. Identify the docs scope (all commands vs specific folders).
2. Run the relevant automation scripts:
   • scripts/generate-command-docs.js
   • scripts/enhance-command-docs.js
   • scripts/populate-command-docs.js
   • scripts/generate-sidebar-config.js or scripts/generate-sidebar-config-fixed.js
3. Spot-check updated markdown for formatting and taxonomy alignment.
4. If needed, run vitepress build docs to validate the output.

Notes

• Follow the command documentation instructions for docs/02-commands/.
• Preserve existing category names and ordering in the sidebar.
• Use existing scripts rather than manual edits whenever possible.

References

• Docs automation checklist