skills.rest
geoffjay
geoffjayCOMMUNITY
Explore all skills by this author →
GitHub

documentation-update

Regenerate marketplace documentation files from data using Jinja2 templates.

8|2|Updated Oct 17, 2025
Search Tags:#automation#developer tools#documentation#markdown#plugins#marketplace#Jinja2
One-click install
npx skills add https://github.com/geoffjay/claude-plugins --skill documentation-update
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: documentation-update
Source: https://github.com/geoffjay/claude-plugins/tree/main/plugins/claude-plugin/skills/documentation-update
Command: npx skills add https://github.com/geoffjay/claude-plugins --skill documentation-update

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jinja2, and includes scripts (resource) and assets (resource) and references (resource) components.

What problem does it solve?

Manually updating documentation for a growing marketplace of plugins, agents, and skills is time-consuming and prone to inconsistencies. This Skill automates the process, ensuring your documentation is always in sync with the latest marketplace data.

Core Features & Use Cases

  • Automated Doc Generation: Regenerates agents.md, agent-skills.md, plugins.md, and usage.md from marketplace data using Jinja2 templates.
  • Dynamic Content: Populates documentation with agent names, descriptions, models, skill triggers, plugin versions, and usage examples, ensuring accuracy.
  • Integration: Designed to be invoked automatically after plugin operations (add, update, remove) to keep documentation current without manual intervention.
  • Use Case: After adding a new plugin or updating an existing one in the marketplace, a developer needs to ensure all public-facing documentation reflects these changes. This Skill runs a Python script to automatically update all relevant Markdown files, saving manual effort and preventing outdated information.

Quick Start

Generate all documentation files

python doc_generator.py

Generate specific file only

python doc_generator.py --file agents

Dry run (show output without writing)

python doc_generator.py --dry-run

Frequently Asked Questions about documentation-update

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

FAQPage Schema
How do I keep documentation in sync with marketplace data automatically?▼

Documentation regeneration automatically updates agents.md, agent-skills.md, plugins.md, and usage.md from marketplace.json and plugin frontmatter using Jinja2 templates, ensuring docs reflect current plugin versions, skill metadata, and agent configurations without manual edits.

Can I generate documentation from marketplace data using Jinja2 templates?▼

Yes. This Skill renders Jinja2 templates to populate documentation with agent names, descriptions, models, skill triggers, and plugin versions extracted from marketplace.json and plugin frontmatter, producing consistent, up-to-date markdown files.

How do I automate documentation updates after adding or updating plugins?▼

Run the Python workflow (doc_generator.py) after plugin operations to automatically regenerate all documentation files. Use --file to target specific docs, --dry-run to preview changes, or custom paths to control output location.

What happens if Jinja2 isn't available for template rendering?▼

The Skill falls back to a simple template engine to render documentation files, ensuring documentation generation continues even without Jinja2 installed, maintaining backwards compatibility.

Can I preview documentation changes before writing files?▼

Yes. Use the --dry-run option with doc_generator.py to display generated documentation output without writing to disk, letting you verify content accuracy before committing changes.

Does this work with existing markdown documentation files?▼

The Skill regenerates markdown files in the docs/ directory by reading marketplace.json and plugin frontmatter, replacing existing content with freshly rendered templates, so documentation stays aligned with live marketplace state.

Related Skills

Explore More Software Engineering Skills→
TorchedHatTorchedHat
6

plugin-writer

Create and configure Claude Code plugins with valid metadata and directory structures.

Official
Intermediate
observatoriogeoobservatoriogeo
2

docs-deploy

Deploy and verify the Weaverlet docs site to GitHub Pages via GitHub Actions.

Community
Advanced
fakolifakoli
4

marketplace-manager

Manage Fakoli marketplace plugins by adding, removing, and validating them.

Community
Intermediate
lluppesmslluppesms

markdown-to-html

Convert Markdown documents to HTML using marked.js, pandoc, or gomarkdown/markdown.

Community
Intermediate