documentation-update

This skill keeps a plugin marketplace's documentation in sync with its catalog by regenerating four Markdown files (agents.md, agent-skills.md, plugins.md, usage.md) from marketplace data using Jinja2 templates. It solves documentation drift: as plugins are added, updated, or removed, hand-maintained reference docs fall out of date, so the skill treats marketplace.json as the single source and rebuilds the docs deterministically from it.

The skill bundles a Python script, doc_generator.py, and four Jinja2 templates in assets/. The script loads and validates marketplace.json, scans plugin files to read agent and command frontmatter and skill metadata, builds a comprehensive component index, prepares a template context (marketplace data, plugins grouped by category, flat lists of all agents, skills, and commands, plus aggregate stats), and renders the templates into the docs/ directory. It supports command-line options to generate all files or a specific one, a --dry-run that shows output without writing, and custom paths for the marketplace file, templates, and output directory. Documented error handling covers a missing marketplace file, missing templates, invalid plugin structure, and frontmatter parse errors. The intended integration is automatic invocation after the create/update plugin commands, so regenerated docs are ready to commit alongside plugin changes.

Target users are maintainers of Claude plugin marketplaces or similar plugin registries who want reproducible, always-current documentation. Use cases include regenerating docs after any plugin add/update/remove, validating and previewing output before writing, and wiring doc generation into a plugin management workflow.