New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Bump

by av1155 in av1155/houndarr

Bump Houndarr version and prepare a release PR. An agent skill from av1155/houndarr.

AGPL-3.0Auto-check passedDevelopment

Install Bump

skills CLI
$ npx skills add av1155/houndarr --skill bump -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install av1155/houndarr bump --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/av1155/houndarr.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bump .claude/skills/bump && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bump
GitHub stars
292
Token cost
~1.2k tokens
SKILL.md length
490 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Bump Houndarr version and prepare a release PR. An agent skill from av1155/houndarr.

  • Works in 11 steps: Read Current Version → Calculate New Version → Verify the Unreleased Block → …
  • The user asks to bump the version
  • SKILL.md covers 1. Read Current Version, 2. Calculate New Version, 3. Verify the Unreleased Block and 4. Present the Promotion Plan…, plus 7 more sections
  • Calls gh, git and python

What it does

Bump is an agent skill from av1155/houndarr. Bump Houndarr version and prepare a release PR. Promotes the Unreleased CHANGELOG block to a versioned block, runs quality gates, opens the PR. Use when the user asks to bump the version, prepare a release, or run /bump. Trigger phrases include bump, release, version bump, prepare release.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Quality gates and Changelog and release notes. It works with Python. The repository describes itself as: Self-hosted arr companion for controlled missing, cutoff, and upgrade searches. The licence is AGPL-3.0.

When your agent uses it

  • The user asks to bump the version
  • Prepare a release
  • Phrases include bump
  • Prepare release

Example prompts

  • “/bump”

Requirements

  • Python 3
  • Docker

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Read Current Version
  2. Calculate New Version
  3. Verify the Unreleased Block
  4. Present the Promotion Plan for Review
  5. Create Branch and Tracking Issue
  6. Update VERSION File
  7. Promote Unreleased in CHANGELOG.md
  8. Run Quality Gates
  9. Commit and Push
  10. Create PR
  11. Verify the Tag Push

What it can do on your machine

Read from SKILL.md and the folder at commit 9b39fdb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bump loads about 1.2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 490 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from av1155/houndarr at commit 9b39fdb, republished under its AGPL-3.0 licence (© av1155). 490 words, ~1,178 tokens.

Download SKILL.mdSave it as .claude/skills/bump/SKILL.md (or your agent's skills folder).
name
bump
description
Bump Houndarr version and prepare a release PR. Promotes the Unreleased CHANGELOG block to a versioned block, runs quality gates, opens the PR. Use when the user asks to bump the version, prepare a release, or run /bump. Trigger phrases include bump, release, version bump, prepare release.

Bump Version and Release

Prepare a release PR following the Houndarr versioning workflow.

Houndarr follows Keep a Changelog 1.1.0: every shipped PR adds a bullet under ## [Unreleased] as part of its own commit, so by the time bump runs, the upcoming release's bullets are already in the file. This skill's job is to promote the Unreleased block to a versioned block, not to draft one from PR titles.

The user's argument is the version bump kind: patch, minor, or an explicit X.Y.Z.

1. Read Current Version

cat VERSION

Note the current version (plain X.Y.Z, no v prefix).

2. Calculate New Version

  • patch: increment patch (e.g. 1.6.5 → 1.6.6)
  • minor: increment minor, reset patch
  • Explicit X.Y.Z: use as-is

Validate the new version is greater than the current one.

3. Verify the Unreleased Block

3a. Refuse to bump an empty Unreleased
awk '/^## \[Unreleased\]$/{found=1; next} found && /^## \[/{exit} found{print}' CHANGELOG.md

If the extracted block contains nothing more than the trailing ---, stop with "## [Unreleased] is empty. Nothing to release." and do not touch VERSION or CHANGELOG.

3b. Verify every bullet's claim before promoting

Mandatory. For every PR referenced in the Unreleased block:

bash
gh pr view N --repo <owner>/<repo> --json title,body
gh pr diff N --repo <owner>/<repo> | head -400

For any bullet that claims behavior (a default, a UI element, an error string, an API response shape), read the relevant source file and pin the claim to a specific file:line. Adopt the PR author's vocabulary for nuance. Every bullet must be defensible with a concrete reference; if you cannot cite one, rewrite or drop the bullet.

3c. Final filter and language pass

Keep only user-facing entries (Added, Changed, Fixed, Removed, Deprecated, Security). Drop CI/refactor/test-only/docs-only/chore/dep-bump-without-impact entries.

If no user-facing entries remain, report "No user-facing changes in Unreleased. Nothing to release." and stop.

Language pass: rewrite bullets that reference internal Python classes / private helpers / src/... paths, exceed 250 chars without a migration reason, use banned phrasings (various / improved / enhanced / better / seamlessly / robustly / significantly / leverages / utilizes / em dashes), or read as past-tense narration. Use markdown [text](url) for links.

Show full SKILL.md (177 more words)Show less

4. Present the Promotion Plan for Review

Show the planned CHANGELOG.md unified diff. Wait for approval. Do not proceed without confirmation.

5. Create Branch and Tracking Issue

git fetch origin
git checkout -b chore/bump-X.Y.Z origin/main
gh issue create --title "chore: bump version to X.Y.Z" \
  --label "type: chore" --label "priority: medium" \
  --body "Release X.Y.Z with <brief summary of user-facing changes>."

6. Update VERSION File

Write the new version (single line, no v prefix).

7. Promote Unreleased in CHANGELOG.md

Rename ## [Unreleased] to ## [X.Y.Z] - YYYY-MM-DD and insert a fresh empty Unreleased block at the top.

8. Run Quality Gates

.venv/bin/python -m ruff check src/ tests/
.venv/bin/python -m ruff format --check src/ tests/
.venv/bin/python -m mypy src/
.venv/bin/python -m bandit -r src/ -c pyproject.toml

9. Commit and Push

git add VERSION CHANGELOG.md
git commit -m "chore: bump version to X.Y.Z"
git push -u origin HEAD

10. Create PR

gh pr create --title "chore: bump version to X.Y.Z" --body "..."

After merge, remind the user to run git tag vX.Y.Z && git push origin vX.Y.Z to trigger docker.yml, release.yml, and chart.yml.

11. Verify the Tag Push

The tag fires docker.yml and release.yml independently. docker.yml attaches the provenance bundle to the release that release.yml creates, so that upload can fail after the image is already on GHCR. The result is a release that looks complete sitting beside a red workflow run, which is easy to miss.

gh run list --workflow=docker.yml --limit 1
gh release view vX.Y.Z --json assets --jq '.assets[].name'
gh attestation verify oci://ghcr.io/av1155/houndarr:vX.Y.Z --repo av1155/houndarr

Expect a green run, a houndarr-vX.Y.Z.sigstore.json asset on the release, and a verify that reports a matching provenance attestation. If the asset is missing, re-run the failed docker.yml job rather than re-tagging.

© av1155, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/bump of av1155/houndarr.

Open the folder on GitHubat commit 9b39fdb

Compare with similar skills

Bump next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bump compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bump this skillav1155/houndarr292—~1.2kAutomated safety check: PassAGPL-3.0
GAIA Agent Eval Scorecardamd/gaia1.6k—~2.6kAutomated safety check: PassMIT
Sonarcloud Reviewlucasvieirasilva/nx-plugins153—~2.7kAutomated safety check: NotesMIT
Blocking IO Guardbytedance/deer-flow83k—~1.7kAutomated safety check: PassMIT
Quick Mergeapache/magpie112—~4.8kAutomated safety check: PassApache-2.0
Release Skillsnexmoe/eve4213 repos~3.3kAutomated safety check: PassNone

Similar skills

  • GAIA Agent Eval Scorecard

    amd/gaia

    Adds a release eval scorecard to a GAIA hub agent by writing a harness adapter, running a real eval, and wiring the result into the agent's README and release gate.

    1.6k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

  • Sonarcloud Review

    lucasvieirasilva/nx-plugins

    Fetches and triages SonarCloud findings (issues, security hotspots, quality gate) for the current pull request or branch of this repository via the SonarCloud Web API, summarizes them in a markdown…

    153 GitHub stars~2.7k tokensUpdated 9 days ago
    DevelopmentAuto-check: notes

  • Blocking IO Guard

    bytedance/deer-flow

    Adds a runtime test anchor for backend async code that could block the asyncio event loop, and proves the anchor fails when the blocking call returns.

    83k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed

  • Quick Merge

    apache/magpie

    Identify trivial, low-risk PRs in the ready for maintainer review queue of <upstream that pass every quality gate and touch only supplementary areas (docs, changelog, translations, tests) — the…

    112 GitHub stars~4.8k tokensUpdated today
    DevelopmentAuto-check passed

  • Release Skills

    nexmoe/eve

    Universal release workflow. An agent skill from nexmoe/eve.

    421 GitHub starsUsed in 3 repos~3.3k tokens
    DevelopmentAuto-check passed

  • Commitizen

    commitizen-tools/commitizen

    A skill your agent uses for tasks involving Conventional Commits, commit message validation, Commitizen configuration, semantic version bumps, changelog generation, or CI/release automation with the…

    3.5k GitHub stars~839 tokensUpdated today
    DevelopmentAuto-check passed

More from av1155/houndarr

All 9 skills in this repo

  • Check

    av1155/houndarr

    Run Houndarr's full quality gate (ruff lint, ruff format check, mypy, bandit, pytest) and report results in a single table.

    292 GitHub stars~366 tokensUpdated 2 days ago
    Auto-check passed

  • Houndarr Architecture

    av1155/houndarr

    Houndarr's source layout and architectural patterns at file granularity.

    292 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed

  • Houndarr Changelog

    av1155/houndarr

    Houndarr's CHANGELOG.md style guide and entry rules. An agent skill from av1155/houndarr.

    292 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

  • Houndarr Testing

    av1155/houndarr

    Houndarr's pytest patterns. An agent skill from av1155/houndarr.

    292 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed

  • Verify Algorithms

    av1155/houndarr

    Verify probabilistic, distributional, or random behaviour empirically before changing search-engine code.

    292 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

  • Houndarr CI

    av1155/houndarr

    Houndarr's CI workflow reference and branch protection. An agent skill from av1155/houndarr.

    292 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Bump

What does Bump do?

Bump Houndarr version and prepare a release PR. An agent skill from av1155/houndarr. Bump is an agent skill from av1155/houndarr. Bump Houndarr version and prepare a release PR.

When should I use Bump?

Bump fits situations like: the user asks to bump the version; prepare a release; phrases include bump; prepare release.

How do I install Bump in Claude Code?

Run `npx skills add av1155/houndarr --skill bump -a claude-code`. Or copy the skill folder (.agents/skills/bump in av1155/houndarr) into .claude/skills/bump in your project. Claude Code loads it when a task matches its description.

How do I install Bump in Codex?

Run `npx skills add av1155/houndarr --skill bump -a codex`. Or copy the skill folder (.agents/skills/bump in av1155/houndarr) into .agents/skills/bump in your project. Codex loads it when a task matches its description.

Can I use Bump in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add av1155/houndarr --skill bump -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bump, .gemini/skills/bump, .github/skills/bump and .opencode/skills/bump in your project.

What does Bump need to run?

Going by SKILL.md and its folder, Bump needs the command-line tools its instructions call (gh, git and python). Our summary lists: Python 3; Docker.

Does Bump access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bump safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bump use?

Bump is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bump use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bump?

Skills that share tags, products or a category with Bump: GAIA Agent Eval Scorecard (amd/gaia, 1.6k stars), Sonarcloud Review (lucasvieirasilva/nx-plugins, 153 stars), Blocking IO Guard (bytedance/deer-flow, 83k stars) and Quick Merge (apache/magpie, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bump?

av1155 (a GitHub user) maintains it in av1155/houndarr, which has 292 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 5, 2026.

Source: av1155/houndarr on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.