agentleFS
arvindandarvindand/agent-skills/skills/release-review/SKILL.md

release-review

Skill17 starsChanged 12 days agoMITView on GitHub

Assess merge and release readiness for a software repository. Use when the user asks 'can this be merged', 'should we release now', 'what changed since the last release', or requests preparation of a software release.

7 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read repository guidance and inspect local changes before editing.

    line 15
  2. Distinctive:

    Check CI for the candidate's exact commit, merge conflicts, draft state and unresolved review feedback.

    line 17
  3. Distinctive:

    Read what the changes do. Separate user-facing fixes, security maintenance, features and documentation-only changes when choosing whether …

    line 18
  4. Distinctive:

    Use upstream release notes and advisories to explain the benefit and affected configurations.

    line 24
  5. Distinctive:

    Keep versions, changelog, manifests and build fallbacks consistent with the project's conventions.

    line 34
  6. Distinctive:

    Run the existing relevant checks and inspect the final diff.

    line 35
  7. Distinctive:

    Check the artifacts users will install: versions, supported architectures or package contents, and a small real usage smoke test where …

    line 37
  8. Distinctive:

    Start the next snapshot cycle only where that is the project's convention, retaining published metadata at the released version.

    line 39

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Release Review

Requires repository and hosting-service access for live CI and release status.

Ground the recommendation in the current repository state and its release conventions.

Establish the release candidate

  • Read repository guidance and inspect local changes before editing.
  • Identify the intended PR or branch, current remote head, latest stable release and changes since its tag. Local branches and tags may be stale.
  • Check CI for the candidate's exact commit, merge conflicts, draft state and unresolved review feedback. A successful run on an older commit does not validate a new head.
  • Read what the changes do. Separate user-facing fixes, security maintenance, features and documentation-only changes when choosing whether and how to release.

Look past direct version bumps

For dependency updates, inspect the effective dependency graph or BOM-managed versions. An explicit override can keep an older dependency even after its parent is upgraded. Verify the resolved version before removing an override.

Use upstream release notes and advisories to explain the benefit and affected configurations. An incomplete security lookup is unknown, not evidence that a version is safe. Patch/minor labels alone do not prove compatibility.

Give an actionable recommendation

State whether the candidate can merge, whether a release is worthwhile, and any specific remaining blocker. Include the candidate commit and links to relevant checks. Distinguish failed, pending and intentionally skipped jobs. Scale verification to the change and the repository's existing checks.

A review request authorizes inspection and recommendations. Follow the user's actual authorization for edits, merges, tags and publication; do not treat those actions as implied by a request to check readiness.

When preparation or publication is requested

  • Keep versions, changelog, manifests and build fallbacks consistent with the project's conventions. Do not bump unrelated dependencies to fill out a release.
  • Run the existing relevant checks and inspect the final diff. Recheck the candidate head before merging.
  • Tag the validated commit according to the repository's release flow. If a tag starts artifact publication, keep the release draft until the artifact checks pass.
  • Check the artifacts users will install: versions, supported architectures or package contents, and a small real usage smoke test where appropriate. A successful source build does not verify published artifacts.
  • Publish within the authorized scope, then confirm any downstream registry publication. Report partial failures precisely; do not conceal them with a successful tag or release page.
  • Start the next snapshot cycle only where that is the project's convention, retaining published metadata at the released version.

For a long build, report meaningful phase changes and check for failures. Follow the hosting service's retry limits; investigate a failed run before retrying it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.