1. Habit
  2. Skills
  3. Documentation Update skill
geoffjay · 2K installs

Documentation Update skill
Runs by itself, marketplace.json changes.

Plugin docs match the marketplace.

Install the Documentation Update skill and make it a habit: follow https://gethabit.dev/skills/geoffjay/documentation-update.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

2K installs8 starsMIT licenceSource on GitHub ↗

Documentation Update

by geoffjay · 2K installs

The skill

Documentation update is a skill for plugin marketplace maintainers that regenerates agents.md, agent-skills.md, plugins.md and usage.md from marketplace.json with Jinja templates whenever plugins change.

Only when you ask.

The habit

Plugin docs match the marketplace.

↻ Runs by itselfmarketplace.json changes

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

marketplace.json changes. Runs in GitHub Actions or Claude Code routine.

  • ↻ marketplace.json changes
  • push touching .claude-plugin/marketplace.json

02

It checks its work

generator runs clean. If a check fails, it tries again.

  • ✓python doc_generator.py exits 0
  • ✓all four docs files exist in docs/
  • ✓no template rendering errors are printed

03

It remembers

docs commit history. The next run reads it first: the last generated docs and plugin stats.

docs/

One run, step by step.
Then it stops.

Stop ruleStops after one regeneration per change, with one retry.

  1. 01

    Validate first

    Run marketplace validation and fix errors before generating.

  2. 02

    Dry run

    Run python doc_generator.py --dry-run to preview the output.

  3. 03

    Generate

    Run python doc_generator.py to write the docs into docs/.

  4. 04

    Review output

    Check links, formatting and stats against the marketplace.

  5. 05

    Stage changes

    Commit the docs together with the plugin change.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Documentation Update skill helps.

Use it when

  • ✓ You add a plugin to the marketplace
  • ✓ You update a plugin's agents
  • ✓ Docs no longer match the catalog

Skip it when

  • – You have no marketplace.json
  • – You write docs by hand

Questions

Documentation Update skill, answered.

Which commands call it?

The skill says /claude-plugin:create and /claude-plugin:update should invoke it after updates.

Does it need extra packages?

The skill lists Python 3.8+ with the standard library only.

How do I install the Documentation Update skill?

Copy the prompt at the top into your agent. It installs the skill from geoffjay/claude-plugins and sets up the habit. Or run npx skills add geoffjay/claude-plugins --skill documentation-update.

Is the Documentation Update skill free?

Yes. It is published under MIT. Habit is free too.

Documentation Update. Now as a habit.

Install the Documentation Update skill and make it a habit: follow https://gethabit.dev/skills/geoffjay/documentation-update.md

  • Free
  • No account
  • Undo in one line

All geoffjay skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by geoffjay, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.