К основному содержанию
скилл CX Codex

pp-docker-hub — скилл для Claude Code: что делает и как установить

Скилл pp-docker-hub для Claude Code ищет публичные образы на Docker Hub и собирает метаданные репозиториев без браузера. Используется при подборе базовых контейнеров и проверке обновлений.

Apache-2.0 295 установок ★ 2 142 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mvanhorn/printing-press-library --skill pp-docker-hub -a claude-code
Открыть на GitHub

Что делает pp-docker-hub

Скилл связывает агента с утилитой docker-hub-pp-cli, обращаясь к публичному API Docker Hub. Он умеет выполнять полнотекстовый поиск по реестру, а также запрашивать число звёзд, скачиваний, дату последнего обновления и описание контейнера по связке <namespace> <repository>. Для работы учётная запись не нужна: запросы идут к открытым эндпоинтам.

Утилита оптимизирована под контекст агента. Режим --agent отключает интерактивные запросы и выводит компактный JSON, а ключ --select отсекает лишние поля и экономит токены. Результаты выполнения можно сразу отправить в файл через file:<path> или переслать по адресу webhook:<url>.

Скилл работает строго в режиме чтения: публиковать, обновлять или удалять образы через него нельзя. Без установленного бинарника docker-hub-pp-cli в системном $PATH агент выполнить команды не сможет.

Какие задачи решает

  • найти публичные образы по ключевым словам в Docker Hub
  • проверить число скачиваний и дату обновления базового образа
  • получить метаданные и звёзды чужого репозитория
  • выгрузить результат поиска контейнеров в локальный JSON-файл

Примеры запросов агенту

  • Найди в Docker Hub официальные образы для сборки Rust
  • Покажи метаданные репозитория library/postgres: количество звёзд и дату обновления
  • Выполни поиск по слову nginx в Docker Hub и оставь только поля name и pull_count

Как установить pp-docker-hub

1Через Skills CLI (Vercel)

npx skills add mvanhorn/printing-press-library --skill pp-docker-hub -a claude-code

2Вручную: положить файлы

~/.claude/skills/pp-docker-hub/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pp-docker-hub/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pp-docker-hub

Как установить pp-docker-hub в Claude Code?

Выполните команду npx skills add mvanhorn/printing-press-library --skill pp-docker-hub -a claude-code. Для работы самого инструмента установите бинарник через npx -y @mvanhorn/printing-press-library install docker-hub --cli-only и добавьте путь к нему в переменную $PATH.

Нужен ли API-токен Docker Hub для работы?

Нет, авторизация не требуется. Скилл опрашивает открытый API Docker Hub, а проверить корректность окружения можно вызовом docker-hub-pp-cli doctor.

Можно ли через этот скилл опубликовать новый контейнер?

Нет, инструмент рассчитан только на чтение. Создание, удаление, публикация тегов и изменение удалённых данных заблокированы архитектурой CLI.

Исходный текст

SKILL.md · Apache-2.0
---
name: pp-docker-hub
description: "Printing Press CLI for Docker Hub. Docker Hub public API. Search container images, browse tags, check sizes, inspect Dockerfiles, and explore the..."
author: "Hiten Shah"
license: "Apache-2.0"
argument-hint: "<command> [args] | install cli|mcp"
allowed-tools: "Read Bash"
metadata:
  openclaw:
    requires:
      bins:
        - docker-hub-pp-cli
    install:
      - kind: go
        bins: [docker-hub-pp-cli]
        module: github.com/mvanhorn/printing-press-library/library/developer-tools/docker-hub/cmd/docker-hub-pp-cli
---
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/docker-hub/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Docker Hub — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `docker-hub-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install docker-hub --cli-only
   ```
2. Verify: `docker-hub-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/docker-hub/cmd/docker-hub-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Command Reference

**docker-hub-search** — Manage docker hub search

- `docker-hub-pp-cli docker-hub-search` — Full-text search across all Docker Hub repositories. Returns name, description, stars, and pull counts.

**repositories** — Repository metadata and details

- `docker-hub-pp-cli repositories <namespace> <repository>` — Full metadata for a Docker Hub repository including pull count, stars, description, and last update time.


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
docker-hub-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Auth Setup

No authentication required.

Run `docker-hub-pp-cli doctor` to verify setup.

## Agent Mode

Add `--agent` to any command. Expands to: `--json --compact --no-input --no-color --yes`.

- **Pipeable** — JSON on stdout, errors on stderr
- **Filterable** — `--select` keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  ```bash
  docker-hub-pp-cli docker-hub-search --agent --select id,name,status
  ```
- **Previewable** — `--dry-run` shows the request without sending
- **Offline-friendly** — sync/search commands can use the local SQLite store when available
- **Non-interactive** — never prompts, every input is a flag
- **Read-only** — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

### Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

```json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
```

Parse `.results` for data and `.meta.source` to know whether it's live or local. A human-readable `N results (live)` summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

## Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

```
docker-hub-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
docker-hub-pp-cli feedback --stdin < notes.txt
docker-hub-pp-cli feedback list --json --limit 10
```

Entries are stored locally at `~/.docker-hub-pp-cli/feedback.jsonl`. They are never POSTed unless `DOCKER_HUB_FEEDBACK_ENDPOINT` is set AND either `--send` is passed or `DOCKER_HUB_FEEDBACK_AUTO_SEND=true`. Default behavior is local-only.

Write what *surprised* you, not a bug report. Short, specific, one line: that is the part that compounds.

## Output Delivery

Every command accepts `--deliver <sink>`. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

| Sink | Effect |
|------|--------|
| `stdout` | Default; write to stdout only |
| `file:<path>` | Atomically write output to `<path>` (tmp + rename) |
| `webhook:<url>` | POST the output body to the URL (`application/json` or `application/x-ndjson` when `--compact`) |

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

## Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

```
docker-hub-pp-cli profile save briefing --json
docker-hub-pp-cli --profile briefing docker-hub-search
docker-hub-pp-cli profile list --json
docker-hub-pp-cli profile show briefing
docker-hub-pp-cli profile delete briefing --yes
```

Explicit flags always win over profile values; profile values win over defaults. `agent-context` lists all available profiles under `available_profiles` so introspecting agents discover them at runtime.

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |

## Argument Parsing

Parse `$ARGUMENTS`:

1. **Empty, `help`, or `--help`** → show `docker-hub-pp-cli --help` output
2. **Starts with `install`** → ends with `mcp` → MCP installation; otherwise → see Prerequisites above
3. **Anything else** → Direct Use (execute as CLI command with `--agent`)
## MCP Server Installation

1. Install the MCP server:
   ```bash
   go install github.com/mvanhorn/printing-press-library/library/other/docker-hub-pp-cli/cmd/docker-hub-pp-mcp@latest
   ```
2. Register with Claude Code:
   ```bash
   claude mcp add docker-hub-pp-mcp -- docker-hub-pp-mcp
   ```
3. Verify: `claude mcp list`

## Direct Use

1. Check if installed: `which docker-hub-pp-cli`
   If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the `--agent` flag:
   ```bash
   docker-hub-pp-cli <command> [subcommand] [args] --agent
   ```
4. If ambiguous, drill into subcommand help: `docker-hub-pp-cli <command> --help`.

© Hiten Shah · Apache-2.0 · mvanhorn/printing-press-library

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
Docker Hub docker Открывает моделям доступ к Docker Hub API для поиска базовых контейнеров, чтения данных реестра и управления репозиториями через чат. CX Codex +1 docker-sandboxes-kits docker Скилл docker-sandboxes-kits помогает писать, проверять и упаковывать манифесты spec.yaml для Docker Sandboxes по спецификации kit-spec v2. Пригодится при сборке готовых агентов или расширений-миксинов. CX Codex +1 1 100установок docker-essentials sundial-org Скилл docker-essentials для Claude Code — шпаргалка по Docker для запуска контейнеров, просмотра логов, выполнения команд, сборки образов и работы с Compose, сетями и томами. CX Codex +1 166установок learn-docker-k8s-game reason-machines Скилл learn-docker-k8s-game для Claude Code, Codex, Cursor и других ИИ-редакторов запускает интерактивную игру, где Docker и Kubernetes учат через реальные сценарии в терминале. CX Codex +1 801установок docker-expert sickn33 Скилл docker-expert для Claude Code разбирает Dockerfile, Compose-конфиги и рантайм контейнеров. Включается при сборке образа, проверке сборки или поиске причины сбоя контейнера. CX Codex +1 27 500установок docker-patterns affaan-m Скилл docker-patterns с проверенными шаблонами Dockerfile и Docker Compose: локальная разработка, сети, тома, безопасность контейнеров. CX Codex +1 8 600установок

Из того же набора87

Весь набор →
pp-tesla Скилл pp-tesla для полного управления Tesla через CLI: проверка готовности авто, расчёт затрат на зарядку, мониторинг очереди на Supercharger и аудит ключей доступа. CX Codex +1 339установок pp-wanderlust-goat Скилл pp-wanderlust-goat для поиска мест, куда стоит дойти пешком: выдаёт 3–5 вариантов под ваш запрос вместо списка из сорока ближайших точек. CX Codex +1 335установок pp-openrouter Скилл pp-openrouter отслеживает расходы и остатки кредитов в OpenRouter через локальный лог. Помогает проверять бюджеты агентов и следить за сбоями провайдеров до запуска задач. CX Codex +1 328установок pp-agent-capture Скилл pp-agent-capture захватывает окна, записывает видео и конвертирует их в GIF прямо из терминала на macOS. Работает с конкретными приложениями благодаря ScreenCaptureKit, собирает доказательства для PR и мониторит изменения UI. CX Codex +1 306установок pp-sentry Скилл pp-sentry для управления Sentry через CLI: ищет инциденты, запрашивает проекты и выгружает данные в JSON для агентов. CX Codex +1 281установок pp-ebay Скилл pp-ebay для аналитики eBay: средняя цена проданных за 90 дней с отсечкой выбросов, поиск аукционов по числу ставок и времени до конца, локальная база для кросс-листингов. CX Codex +1 273установок pp-nvd Скилл pp-nvd для Claude Code ищет CVE в National Vulnerability Database по продукту, идентификатору или ключевым словам и показывает связанные оценки CVSS. Помогает проверить зависимость на уязвимости. CX Codex +1 271установок pp-pypi Скилл pp-pypi управляет CLI для чтения данных PyPI: метаданных пакетов, версий, файлов релизов и уязвимостей. Подходит для проверки зависимостей. CX Codex +1 270установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой