release-update-published-version

Automates updating documentation and metadata for released software versions.

2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/clawperator/clawperator --skill release-update-published-version
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-update-published-version
Source: https://github.com/clawperator/clawperator/tree/main/.agents/skills/release-update-published-version
Command: npx skills add https://github.com/clawperator/clawperator --skill release-update-published-version

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the post-release housekeeping required after a new Clawperator version goes live. It ensures public-facing surfaces reflect the latest version and that associated build outputs are regenerated and committed, reducing manual effort and avoiding version drift.

Core Features & Use Cases

  • Updates the docs home page badge and version references across docs/ and sites/ surfaces.
  • Regenerates and commits release-facing artifacts such as built docs and stage outputs to keep the public site in sync with npm and GitHub releases.
  • Enforces safeguards by validating that the target version is published on both npm and GitHub Releases before applying changes.

Quick Start

Execute .agents/skills/release-update-published-version/scripts/update_published_version.py <version> after the new release goes live.

Frequently Asked Questions about release-update-published-version

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

FAQPage Schema
How do I automate version updates across docs and site assets after publishing an npm release?

Automate post-release version updates by running a script that syncs docs home page badges, version references, and site assets after npm and GitHub releases go live. It regenerates build outputs and commits the changes to prevent version drift.

What is the safest way to sync release-facing documentation after a new npm package version goes live?

The safest way to sync release-facing docs is to enforce validation checks ensuring the target version exists on both npm and GitHub Releases before applying changes and committing updates to public-facing surfaces.

How do I prevent version drift in public documentation sites following GitHub releases?

Prevent version drift by automating the update of version references across docs and sites directories, which regenerates and commits built artifacts to keep the public site synchronized with the latest release.

Can I use this automation to update version badges and regenerate build outputs for staged sites?

Yes, you can use this automation to update version badges on the docs home page and regenerate release-facing artifacts such as built docs and stage outputs, ensuring public surfaces reflect the latest version.

Do I need to verify npm and GitHub releases before running the post-release update script?

You do not need to manually verify releases because the script implements safety checks that validate the target version exists on both npm and GitHub Releases before applying any changes.

Why does the release update script fail to apply changes when the target version is missing from npm?

The release update script fails because it enforces safeguards that require the target version to be successfully published on both npm and GitHub Releases before applying any documentation or asset updates.