Agent skill

Houndarr CI

by av1155 in av1155/houndarr

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

AGPL-3.0Auto-check passedDevOps & Cloud

Install Houndarr CI

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

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

GitHub CLI
$ gh skill install av1155/houndarr houndarr-ci --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/houndarr-ci .claude/skills/houndarr-ci && 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
houndarr-ci
GitHub stars
292
Token cost
~1.2k tokens
SKILL.md length
544 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Tasks that involve Containers
  • SKILL.md covers Required checks (11; branch…, Additional workflows (not…, Branch protection on main and Don't break this
  • Calls ruff, mypy and pytest

What it does

Houndarr CI is an agent skill from av1155/houndarr. Houndarr's CI workflow reference and branch protection. Loads when reading or editing .github/workflows/. Covers the 11 required status checks (exact names matter for branch protection), the additional non-required workflows, the paths-ignore + ci-skip pattern that keeps docs-only PRs green, and the rule against changing required check job names.

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 DevOps & Cloud, covering Containers. It works with GitHub Actions, Docker, Python and Ruff. 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

  • Tasks that involve Containers

Example prompts

  • “/houndarr-ci”

Requirements

  • Python 3
  • Docker

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:

    • ruff
    • mypy
    • pytest
    • uv
    • trivy
    • hadolint

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

  • Network

    No URLs in SKILL.md. Its commands use uv, 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

Houndarr CI loads about 1.2k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 544 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
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). 544 words, ~1,225 tokens.

Download SKILL.mdSave it as .claude/skills/houndarr-ci/SKILL.md (or your agent's skills folder).
name
houndarr-ci
description
Houndarr's CI workflow reference and branch protection. Loads when reading or editing .github/workflows/. Covers the 11 required status checks (exact names matter for branch protection), the additional non-required workflows, the paths-ignore + ci-skip pattern that keeps docs-only PRs green, and the rule against changing required check job names.
paths
.github/workflows/**

Houndarr CI conventions

Required checks (11; branch protection enforced)

Check nameWorkflow fileWhat it runs
Lint (ruff)quality.ymlruff check .
Format (ruff)quality.ymlruff format --check .
Type check (mypy)quality.ymlmypy src/
Test (Python 3.13)tests.ymlpytest -q --tb=short + compile check + --help
Dependency audit (pip-audit)security.ymlpip-audit against requirements.txt + requirements-dev.txt generated on the fly via uv export --frozen from pyproject.toml + uv.lock
SAST (bandit)security.ymlbandit -r src/ -c pyproject.toml
Trivy filesystem scansecurity.ymltrivy fs . (CRITICAL/HIGH with known fix)
Dependency reviewdependency-review.ymlPR dependency diff vs GitHub Advisory Database
Build (no push)docker.ymlMulti-arch Docker build (amd64/arm64), no push
Trivy image scandocker.ymlTrivy scan of built Docker image (CRITICAL/HIGH with known fix)
Security smoke testsecurity-smoke-test.ymlLive container: unauthenticated sweep, CSRF, XFF, rate limiting, API key exposure, container security

The six main workflows (quality, tests, security, dependency-review, docker, security-smoke-test) use paths-ignore: ["docs/**", "**/*.md", "website/**", ".claude/**"]. When a PR touches only those paths, ci-skip.yml provides passing no-op jobs with identical check names so branch protection is satisfied.

Additional workflows (not required checks)

WorkflowTriggerPurpose
version-check.ymlPRs changing VERSION or CHANGELOG.mdValidates VERSION format, CHANGELOG heading match, allowed ### headers, --- separator
release.ymlv* tag pushValidates VERSION == tag, extracts CHANGELOG block, creates GitHub Release
chart.ymlv* tag pushPackages charts/houndarr/ with version from VERSION file, pushes to oci://ghcr.io/av1155/charts
dockerfile-lint.ymlChanges to Dockerfilehadolint Dockerfile
workflow-lint.ymlChanges to .github/workflows/**actionlint via reviewdog
api-snapshot-refresh.ymlWeekly (Monday 10:00 UTC) + manualFetches upstream Radarr/Sonarr/Whisparr/Lidarr/Readarr OpenAPI specs, updates docs/api/ snapshots and tests/test_docs_api.py hashes, opens a PR if changed
pages.ymlPushes to main touching website/**Deploys docs site to GitHub Pages
test-deploy.ymlPRs touching website/**Tests Docusaurus build without deploying
link-check.ymlPRs touching **/*.md, **/*.mdx, lychee.toml + weekly (Monday 08:00 UTC) + manualRuns lychee against every Markdown file to catch broken external links; rules live in lychee.toml
cleanup-actions-cache.ymlWeekly (Monday 05:00 UTC) + manualPrunes stale GitHub Actions caches
Show full SKILL.md (233 more words)Show less

Branch protection on main

  • 11 required status checks (strict; branch must be up to date)
  • PRs required, stale reviews dismissed, conversation resolution required
  • Required approving reviews is 0, so no approval blocks a merge
  • Linear history enforced (no merge commits)
  • No force pushes, no branch deletions
  • Admin enforcement is off. The rules above bind contributors; the maintainer account can push to main and merge past a failing check. The hooks in .claude/settings.json are the real block on direct edits and pushes while on main.
  • CODEOWNERS assigns @av1155 to every file, but code owner review is not a required gate

Don't break this

  • Do not modify the 11 required check job names; branch protection depends on exact name matches.
  • Do not change ci-skip.yml job names without updating branch protection.
  • Keep paths-ignore patterns in sync across the six main workflows.
  • If mypy CI fails with "merge ref not found": push an empty commit to retrigger.
  • Keep every action pinned to a full 40-character commit SHA with the release version as the last token of a trailing comment (uses: owner/repo@<sha> # vX.Y.Z). Dependabot rewrites the SHA and the comment together, but only while the version ends the comment. A tag or branch ref can be repointed by the action owner; a SHA cannot. When pinning by hand, dereference annotated tags to their commit: for those actions git/ref/tags/vN returns a tag object whose SHA the runner cannot resolve.

© 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/houndarr-ci of av1155/houndarr.

Open the folder on GitHubat commit 9b39fdb

Compare with similar skills

Houndarr CI 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.

Houndarr CI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Houndarr CI this skillav1155/houndarr292—~1.2kAutomated safety check: PassAGPL-3.0
Code PatternsAedelon/claude-code-blueprint120—~1.2kAutomated safety check: PassCustom licence
DDNS Build and Release MaintenanceNewFuture/DDNS4.7k—~444Automated safety check: PassMIT
DockerEliasOulkadi/shokunin114—~3.8kAutomated safety check: NotesMIT
Devops Deploysickn33/agentic-awesome-skills47k2 repos~1.9kAutomated safety check: PassMIT
Implementing Container Image Minimal Base With Distrolessmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Code Patterns

    Aedelon/claude-code-blueprint

    Reference patterns for REST APIs, pytest/vitest testing, Docker multi-stage builds, GitHub Actions CI/CD, PostgreSQL, TypeScript generics, Python async, and React Server Components.

    120 GitHub stars~1.2k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed
  • Maintains the DDNS project's GitHub Actions, Docker and Nuitka builds, packaging and release preparation without touching publishing credentials.

    4.7k GitHub stars~444 tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Docker

    EliasOulkadi/shokunin

    Optimize Docker images with multi-stage builds, distroless bases, BuildKit cache mounts, multi-arch builds, compose watch, security hardening (non-root, seccomp, capabilities drop), and…

    114 GitHub stars~3.8k tokensUpdated 5 days ago
    DevOps & CloudAuto-check: notes
  • Devops Deploy

    sickn33/agentic-awesome-skills

    DevOps e deploy de aplicacoes — Docker, CI/CD com GitHub Actions, AWS Lambda, SAM, Terraform, infraestrutura como codigo e monitoramento.

    47k GitHub starsUsed in 2 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Implementing Container Image Minimal Base With Distroless

    mukul975/Anthropic-Cybersecurity-Skills

    Reduces container attack surface by building application images on Google distroless base images that ship only the application runtime - no shell, package manager, or OS utilities - using…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Uv

    harperreed/dotfiles

    uv workflows for Python — dependencies, virtualenvs, PEP 723 scripts, Python version management, CI, and Docker.

    334 GitHub stars~1.1k tokensUpdated 7 days ago
    DevOps & CloudAuto-check passed

More from av1155/houndarr

All 9 skills in this repo
  • Bump

    av1155/houndarr

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

    292 GitHub stars~1.2k tokensUpdated 5 days ago
    Auto-check passed
  • 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 5 days ago
    Auto-check passed
  • Houndarr Architecture

    av1155/houndarr

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

    292 GitHub stars~2k tokensUpdated 5 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 5 days ago
    Auto-check passed
  • Houndarr Testing

    av1155/houndarr

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

    292 GitHub stars~1k tokensUpdated 5 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 5 days ago
    Auto-check passed

Questions about Houndarr CI

What does Houndarr CI do?

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

When should I use Houndarr CI?

Houndarr CI fits situations like: tasks that involve Containers.

How do I install Houndarr CI in Claude Code?

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

How do I install Houndarr CI in Codex?

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

Can I use Houndarr CI 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 houndarr-ci -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/houndarr-ci, .gemini/skills/houndarr-ci, .github/skills/houndarr-ci and .opencode/skills/houndarr-ci in your project.

What does Houndarr CI need to run?

Going by SKILL.md and its folder, Houndarr CI needs the command-line tools its instructions call (ruff, mypy, pytest, uv, trivy and hadolint). Our summary lists: Python 3; Docker.

Does Houndarr CI access the network?

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

Is Houndarr CI 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 Houndarr CI use?

Houndarr CI 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 Houndarr CI use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Houndarr CI?

Skills that share tags, products or a category with Houndarr CI: Code Patterns (Aedelon/claude-code-blueprint, 120 stars), DDNS Build and Release Maintenance (NewFuture/DDNS, 4.7k stars), Docker (EliasOulkadi/shokunin, 114 stars) and Devops Deploy (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Houndarr CI?

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.