Skip to main content
ZICQ

Skills ZICQ category:DevOps & Cloud runpod-companion-clis

Runpod Companion Clis

Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS. Use runpod-build-template for complete template project authoring, and the ComfyUI model-repair guide in runpod-templates for imported workflows lacking model download metadata.

1379 installs

Official URL:skills.sh

What this skill does

Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.

What it does

Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS. Use runpod-build-template for complete template project authoring, and the ComfyUI model-repair guide in runpod-templates for imported workflows lacking model download metadata.

When to use it

The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.

How agents load it

Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Companion CLIs; Windows: choose the shell, then set up WSL2 if needed; HuggingFace CLI; GitHub CLI; Docker; AWS CLI.

File analysis

File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.

Companion CLIsWindows: choose the shell, then set up WSL2 if neededHuggingFace CLIGitHub CLIDockerAWS CLI

Compatibility:Linux, macOS, Windows · License:Apache-2.0

Source category:skills.sh agent-skill

SKILL.md & Agent activation

Official spec ↗
name
runpod-companion-clis
description
Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS. Use runpod-build-template for complete template project authoring, and the ComfyUI model-repair guide in runpod-templates for imported workflows lacking model download metadata.
compatibility
Linux, macOS, Windows
License
Apache-2.0
  1. DiscoverThe client exposes names and descriptions to the agent.
  2. ActivateYour request or the task context selects the skill and loads its instructions.
  3. Load resourcesReferenced scripts, documentation and assets are used when needed.

Invocation syntax and available tools depend on your Agent client. Client integration guide ↗

Install this skill

Skills CLI ↗

Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.

Ask your Agent to install

Copy these instructions to a compatible agent and confirm the target directory matches your client.

Install the agent skill "runpod-companion-clis" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-e47292903a43a808-Runpod-Companion-Clis.html
Save it as .cursor/skills/runpod-companion-clis/SKILL.md or .claude/skills/runpod-companion-clis/SKILL.md and keep the frontmatter name and description exactly as-is.

Full package on GitHub ↗

Install from the terminal · Skills CLI

Requires Node.js and npx. First inspect the repository's skill list to confirm the name.

npx skills add 'https://github.com/runpod/runpod-plugins-official' --list

npx skills add 'https://github.com/runpod/runpod-plugins-official' --skill 'runpod-companion-clis'

The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.

Readable layout
--- name: runpod-companion-clis description: Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS. Use runpod-build-template for complete template project authoring, and the ComfyUI model-repair guide in runpod-templates for imported workflows lacking model download metadata. compatibility: Linux, macOS, Windows metadata: author: runpod version: "2.2.1" # x-release-please-version concepts: [container-image, network-volume, hub-repo] license: Apache-2.0 --- # Companion CLIs For creating or improving a documented template project, start with [runpod-build-template](../runpod-build-template/SKILL.md); return here for the selected CLI operation. Four CLIs commonly needed alongside Runpod. Each has its own **credentials + command reference** in [`reference/`](reference/) — plus a one-time `-setup.md` for install (only opened if the CLI isn't installed). Load only the one the task needs, not all four. If the request starts with an imported ComfyUI workflow whose model filenames lack verified URLs or hashes, route to the [ComfyUI model-repair guide](../runpod-templates/reference/comfyui-model-repair.md) in runpod-templates. Return here when the exact Hugging Face repository/file is already known and the task is simply to download, cache, or bake that artifact. | CLI | Use it to | Full reference | |-----|-----------|----------------| | `hf` (HuggingFace) | Download models from the Hub to cache/bake into images | [reference/huggingface.md](reference/huggingface.md) | | `gh` (GitHub) | Manage worker repos + cut releases (Hub indexes releases) | [reference/github.md](reference/github.md) | | `docker` | Build/validate/push images to Docker Hub for Runpod to pull | [reference/docker.md](reference/docker.md) | | `aws` (S3) | Read/write network-volume storage over Runpod's S3 API | [reference/aws.md](reference/aws.md) | Each requires credentials before use. Read the per-tool reference for auth steps and commands; install is a separate one-time `-setup.md`. These CLIs are usually one step inside a larger job. For the whole job the verified example is in [runpod/golden-paths/README.md](../runpod/golden-paths/README.md) — baking vs mounting a model ([25](../runpod/golden-paths/25-bake-vs-mount/README.md)), building a minimal image ([22](../runpod/golden-paths/22-minimal-pod-image/README.md)), or moving data to a network volume ([07](../runpod/golden-paths/07-network-volume-handoff.md)). These are third-party CLIs on their own release trains, so **` --help` is authoritative for flags and subcommands** — the references here cover the Runpod-specific usage and the traps, not the tool's full surface. Check `--help` before reporting that one of them cannot do something. ## Windows: choose the shell, then set up WSL2 if needed Check existing native, WSL2 or remote tools before installing another copy. The Windows `hf` and `gh` setup recipes in this skill use WSL2 and their Linux installers. If choosing that route and WSL2 is missing, run this in PowerShell as Administrator, then restart if prompted: ```powershell wsl --install ``` Afterward open the Ubuntu app to finish setup, then follow the **Linux** instructions in each reference. Keep commands, credentials and paths in the selected environment. File authoring alone does not require installing these CLIs. ## HuggingFace CLI Download models locally so they're cached for a Docker build/run. Auth and `hf download` recipes: **[reference/huggingface.md](reference/huggingface.md)** (install: [reference/huggingface-setup.md](reference/huggingface-setup.md)). - Use the standalone `hf` CLI, **not** `pip install huggingface_hub` (that's the older `huggingface-cli` with different syntax). - Auth via `hf auth login`, or `export HF_TOKEN=hf_...` (env var wins over saved token). ## GitHub CLI Manage worker repositories and cut releases. Auth and commands: **[reference/github.md](reference/github.md)** (install + SSH-key setup: [reference/github-setup.md](reference/github-setup.md)). - **The Hub indexes releases, not commits** — every Hub listing update needs a new `gh release create`. - One SSH key (`ssh-keygen -t ed25519`) registers with both GitHub (`gh ssh-key add`) and HuggingFace (paste in browser). ## Docker Build, validate, and push images to Docker Hub. Credentials and commands: **[reference/docker.md](reference/docker.md)** (install: [reference/docker-setup.md](reference/docker-setup.md)). - **Always build `--platform=linux/amd64`** — Runpod runs on x86 Linux. - **Always use explicit semantic tags; never `latest`** — `latest` doesn't track the newest push, so workers can silently pull the wrong image. - Docker Hub auth uses a **personal access token**, not your password. For private images, register the credential once in Console → Container Registry Settings. ## AWS CLI Access network-volume storage over Runpod's S3-compatible API (bucket name = network volume ID). Credentials, region rules, and commands: **[reference/aws.md](reference/aws.md)** (install: [reference/aws-setup.md](reference/aws-setup.md)). - Runpod's S3 API, **not AWS**: access key = Runpod **user id** (`user_...`), secret = S3 API key (`rps_...`). - **S3 API keys are Console-only.** No `runpodctl`/REST/GraphQL creates them — if they're not already in `~/.aws/credentials`/env and S3 access is needed, **stop and ask the user** to generate them (Settings > S3 API Keys). - Every command needs `--region DATACENTER --endpoint-url https://s3api-DATACENTER.runpod.io/` (datacenter = the volume's DC, not an AWS region). - For large/many-file transfers with resume, prefer `runpodctl network-volume upload`/`download` (v3.1.0+, same S3 API keys; see the `runpodctl` skill). On an older runpodctl, see [reference/aws.md → optional resumable volume transfers](reference/aws.md#optional-resumable-volume-transfers-community-tool).

Related skills

DevOps & Cloud

Docker Essentials

Essential Docker commands and workflows for container management, image operations, and debugging.

DevOps & Cloud

Find Skills

Discover and install skills from the open agent skills ecosystem. Use when: (1) user asks "how do I do X" where X might have an existing ski…

DevOps & Cloud

Microsoft Foundry

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd a…

DevOps & Cloud

Azure Deploy

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT us…