release

SkillDev tools

Quality-check, commit, push, create PR, and cut a release in one flow.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the release skill

What this skill tells your AI

The instructions your AI receives, as published by the-agency-ai/the-agency in .claude/skills/release/SKILL.md and read by ahel’s review.

Release

Quality-check, commit, push, create PR, and cut a release in one flow. The "code is ready" command. Every PR is a release.

Arguments

  • $ARGUMENTS: May contain --no-push (skip push) or --no-pr (skip PR creation). Remaining text is the commit description.

Steps

Step 1: Pre-flight

  1. Get current branch. If on master, abort.
  2. Show git status and git diff --stat HEAD.
  3. If no changes, tell the user and stop.

Step 2: Quality gate

Run ./agency/tools/commit-precheck to verify formatting, linting, and tests pass.

If any check fails, stop and report the failures. Do not proceed.

Step 3: Commit

Invoke /git-safe-commit via the Skill tool. Pass any commit description from $ARGUMENTS.

Step 4: Push (unless --no-push)

If --no-push was NOT passed:

  1. Show what will be pushed: git log --oneline origin/{branch}..HEAD
  2. Ask for confirmation
  3. ./agency/tools/git-push --force-with-lease {branch}

Step 5: PR (unless --no-pr)

If --no-pr was NOT passed and a push happened:

  1. Check if a PR already exists: gh pr view {branch}
  2. If exists: report the PR URL
  3. If not: create one with ./agency/tools/pr-create --title "..." --body "..."

Never raw gh pr create. The pr-create tool validates a QGR receipt exists before allowing PR creation. If no QGR is found, it blocks — run /pr-prep first.

Step 6: Version bump

  1. Parse the PR title for the release version (D#-R# → version #.#)
  2. Update agency/config/manifest.json: bump agency_version, update updated_at
  3. Commit the version bump
  4. Push the version bump: ./agency/tools/git-push {branch}

Step 7: Summary

Release complete:
  Committed: {commit-hash} {message}
  Version: {old} → {new}
  Pushed: origin/{branch}
  PR: {url} (or skipped)
  Post-merge: run /post-merge after PR is merged to create GitHub release

Signals

GitHub stars
55
Forks
8
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
release-the-agency-ai
Source
github.com/the-agency-ai/the-agency