Skill

docker-hub

Docker Hub public API. Search container images, browse tags, check sizes, inspect Dockerfiles, and explore the world's largest container registry. No authentication required for public repositories (rate limited to ~18 req/min).

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use docker-hub

Choose if

You're inside an agent loop and need read-only Docker Hub data — image search, tag listings, pull counts, sizes, Dockerfile inspection — with typed exit codes (0/4/7) and agent-friendly compact output. No API key required for public repositories, so it's the lowest-friction way to reason about container images vs. shelling out to `docker search` or scraping the web UI.

Avoid if

You need to push, tag, or otherwise mutate images on Docker Hub (the CLI is read-only) or your workload exceeds the ~18 req/min anonymous rate limit without an authenticated token. For private-repo metadata the README does not promise coverage — use the Docker Hub web UI or authenticated REST API directly.

Risk Flags

  • MEDIUM rate_limit Docker Hub throttles unauthenticated public-API requests to roughly 18 req/min. The CLI surfaces hits as exit code 7; bulk agent workloads must pace or supply an auth token.
  • LOW scope Read-only by default — cannot create, update, delete, publish, send, or mutate Docker Hub state. Public-repo coverage only without authentication.

Cost

Type: Free

Install

Default

npx -y @mvanhorn/printing-press install docker-hub

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+ for source install

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT