Skip to content

Guide · Agent skill

How to use the Antigravity Maintainer Batch Release agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The Antigravity Maintainer Batch Release skill is a detailed maintainer playbook for an AI agent working on the agentic-awesome-skills repository. It covers reviewing and merging pull requests in batches, preparing and publishing releases to npm and GitHub, and checking the public catalog and Pages surfaces. It is written for repository maintainers, not ordinary contributors, and this guide explains what it does, how to install it, how to trigger it and what safety rules it enforces.

Antigravity Maintainer Batch Releasesickn33/agentic-awesome-skills · MIT

Quick start

  1. 1Confirm maintainer access. Make sure you have Git and GitHub maintainer permissions on the repository, plus Node.js and npm. Release steps also need npm publishing credentials and GitHub release rights.
  2. 2Download and install the ZIP. Download the skill ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into .claude/skills/ in your project. You can also upload it under Settings → Capabilities → Skills in the Claude apps.
  3. 3Create a private state directory. Create a directory outside your source checkouts with mode 0700 for run state. The skill requires it for merge and release steps.
  4. 4Ask for a task in plain language. Name the repository and the maintainer work, such as reviewing specific PR numbers or preparing a release.
  5. 5Run a safe analysis first. Use npm run merge:batch with --prepare-only to prepare analyses without merging, and review the results.
  6. 6Complete review before merging. After a real semantic review, let the skill persist evidence and merge with the exact full commit SHA. Never merge on a heuristic score alone.
  7. 7Verify the outcome. Run maintenance:cycle verify on exact current main and check the public surfaces the skill lists for your change.

What is an agent skill, and what does this one do?

An agent skill is a folder containing a SKILL.md file and supporting reference files. When an AI coding agent such as Claude loads the skill, it reads these instructions and follows them for matching tasks.

This skill tells the agent how to run maintainer work on the agentic-awesome-skills repository: triaging and reviewing pull requests in batches, running protected merge commands, preparing and publishing releases, and verifying public catalog and Pages surfaces. It names the checks, scripts and reference documents to follow.

  • Runs maintainer PR sweeps and merge batches with protected main and admin enforcement kept on.
  • Prepares and publishes releases to npm and GitHub, and checks the published bytes.
  • Verifies catalog, Pages and legacy redirect changes.
  • Covers Core checks for CLI, MCP and Workbench changes.
  • Does not cover ordinary contribution work such as submitting a skill or fixing a bug.

Check that you are allowed to use it

The skill is written for maintainers. Its merge and release steps need repository and publishing rights. Without them, the skill is not useful and misuse could cause public changes.

The skill says ordinary contributors do not need maintainer privileges, and it does not cover their work.

  • Node.js and npm, to run the repository scripts such as npm run merge:batch, maintenance:cycle, release:prepare and release:publish.
  • Git and GitHub access with maintainer permissions on the repository.
  • A private state directory outside source checkouts, with mode 0700.
  • npm publishing credentials and GitHub release rights, for release steps only.
  • Optional: Tessl review access. Without it, the skill records manual-review-required rather than a pass.

Install the skill

Download the ZIP for this skill from this page, then choose one of the following options.

For a personal install, unzip it into ~/.claude/skills/. For a project-specific install, unzip it into the project's .claude/skills/ folder. You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

  • Personal: unzip into ~/.claude/skills/
  • Project: unzip into .claude/skills/ inside the project
  • Claude apps: Settings → Capabilities → Skills, then upload

Trigger the skill with natural requests

You do not need a special command. Describe the maintainer task in plain language, and name the repository and the work involved. The skill's description matches requests about repository maintenance, main alignment, CLI, MCP or Workbench changes, and release work.

Requests that fit well include a batch of named pull requests, a release to prepare, or a check of public surfaces after a change. Requests about submitting your own skill are outside its scope.

  • Review PRs 123 and 124 in the agentic-awesome-skills repo and merge them in a batch if they pass.
  • Prepare release 1.2.3 of the runtime, following the maintainer release steps.
  • Verify the catalog and Pages surfaces after this catalog change.

Run a safe analysis before any merge

The skill's example shows how to prepare analyses without merging. Use --prepare-only first so you can review the evidence.

Merging requires a real semantic review of the complete bundle. After that review, the skill persists the evidence in a private state directory and merges using the exact full commit SHA. Use real IDs, paths and a full immutable SHA, and make sure the state directory already exists, is privately owned, has mode 0700, and sits outside source checkouts.

npm run merge:batch -- --prs 123,124 --prepare-only

Safety rules the skill enforces

The skill sets several hard limits. It never pushes directly to main, never bypasses protections, and never uses GitHub auto-merge. It does not treat a heuristic score as a substitute for semantic review. It does not rewrite PR metadata or automatically retry base drift.

The skill runs scripts and uses the network. Read the scripts it runs before using it on a real repository, and run merge and release steps only with the credentials and authority you actually hold. Its own limitations section says it grants no additional publication or messaging authority, and that SkillSpector and timing reports are advisory only.

  • Never push directly to main or use admin bypass.
  • Do not use mutable artifact identity or PR-controlled review receipts.
  • Tessl unavailable means manual-review-required, not a passing review.
  • Closing a PR requires a posted owner rationale bound to its exact head, through maintenance:cycle close.

Tips for using it well

Start with analysis rather than merges, and keep state in a private directory outside your checkout. Work through the references the skill points to, since they hold the exact validation profiles and release proof. Treat the skill as a checklist to follow with your own judgement, not as an autonomous release button.

  • Read the maintenance contract and component validation references before the first real batch.
  • Run maintenance:cycle verify on exact current main before preparing a release.
  • Keep the repository's protections on; the skill assumes they are enforced.
  • Report personal MCP configuration and session reload separately, as the skill instructs.

What people use it for

  • Running a scheduled PR merge sweep on agentic-awesome-skills, with blocked PRs recorded and independent PRs continued.
  • Preparing and publishing a runtime release to npm and GitHub, with the exact npm bytes verified.
  • Publishing a compatible catalog-only update through the independent catalog workflow without bumping the runtime.
  • Checking catalog, Pages and legacy redirect changes after a documentation or catalog update.
  • Auditing your own maintainer workflow for a skill repository against the references this skill provides.

Frequently asked questions

Is the Antigravity Maintainer Batch Release skill free?

The skill is published under the MIT licence, according to its listing. Check the licence file in the source repository for the full terms before you reuse or modify it.

What do I need to run this skill?

You need Node.js and npm to run the repository scripts, Git and GitHub access with maintainer permissions, and a private state directory with mode 0700 outside your checkouts. Release steps also need npm publishing credentials and GitHub release rights. Tessl review access is optional.

Can an ordinary contributor use this skill to submit a skill or fix a bug?

No. The skill states that ordinary contributors do not need maintainer privileges and that it does not cover contribution tasks. For those, use the repository's contributing guide instead.

How do I install it in Claude?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. Alternatively, upload it in the Claude apps under Settings → Capabilities → Skills.

What happens if Tessl review is not available?

The skill records manual-review-required. It does not treat this as a passing review, so merges still need either real Tessl review or exact-head maintainer attestation.

Is this skill safe to run on any repository?

It is not. The commands and paths assume the agentic-awesome-skills project layout and its protections. It runs scripts and uses the network, so review them before use and only run merge and release steps with authority you hold.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits maintainers of the agentic-awesome-skills repository who run PR merge sweeps, prepare releases or verify public surfaces, and who have the required credentials. It is a poor fit for ordinary contributors, for anyone maintaining an unrelated repository, or for anyone without merge and publishing rights, because its steps can make public changes if misused.

Download the skill