PlugWiki

companion-clis skill (Runpod): use hf, gh, Docker and AWS with Runpod

Runpod's own skill that tells a coding agent how to use the hf, gh, Docker and AWS CLIs for Runpod work.

Installs
14K
on skills.sh
Stars
47
on GitHub
Files
8
besides SKILL.md
Updated
Oct 2026
last repo commit

companion-clis makes your coding agent use four outside command line tools for Runpod jobs: hf to download models, docker to build and push images, gh to manage worker repos and releases, and aws to read and write network-volume storage over Runpod's S3 API.

Each CLI needs its own credentials. The agent loads only the guide for the CLI a task needs, and opens the setup guide only if that CLI is not installed.

Good for

  • Developers who build and push Docker images that Runpod pulls
  • People moving files into Runpod network volumes through the S3 API
  • Hub authors who cut GitHub releases for their worker repos

Install companion-clis

Claude Code

  1. 1

    Copy this prompt.

    Install the companion-clis skill in Claude Code. Run this command:
    
    /plugin marketplace add runpod/runpod-plugins-official
    /plugin install runpod@runpod
    /reload-plugins
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. Install the whole set, not only this skill: the runpod skills hand off to each other, and the worked golden-path examples live in the runpod router skill's folder. The plugin also registers the hosted Runpod MCP server, which stays inert until you sign in with /mcp.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

  1. Windows: choose the shell, then set up WSL2 if needed
  2. HuggingFace CLI
  3. GitHub CLI
  4. Docker
  5. AWS CLI

Key facts

Installs on skills.sh
14,001 as of 2026-11-02
Last change to this skill
2026-10-19

What it includes

  • Download models to cache or bake into an image

    Use the standalone hf CLI and not pip install huggingface_hub. Auth is hf auth login or an HF_TOKEN variable.

    Runs code · hf (Hugging Face)

  • Manage worker repos and cut releases

    SKILL.md says the Hub indexes releases and not commits, so every listing update needs gh release create. One SSH key can be registered with GitHub and Hugging Face.

    Runs code · gh (GitHub)

  • Build, validate and push images to Docker Hub

    Always build with --platform=linux/amd64, use explicit version tags and never latest, and log in with a personal access token.

    Runs code · docker

  • Read and write network-volume storage

    The access key is your Runpod user id and the secret is an S3 API key from the console. Every command needs a --region data center and --endpoint-url. The reference includes aws s3 rm and aws s3 sync.

    Delete · aws (Runpod S3 API)

  • Install steps, opened only when the CLI is missing

    Cover brew and installer routes for each CLI, plus WSL2 on Windows.

    Runs code · Per-CLI setup guides

  • Pick a shell, then set up WSL2 if needed

    SKILL.md gives wsl --install in an administrator PowerShell, then follows the Linux steps.

    Runs code · Windows choice

From the official docs

Permissions

Medium risk

The agent handles credentials for four services and can push images, cut releases and delete files in your volume storage. Use scoped tokens and approve each push, release and delete.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can push public images and releases

    docker push sends an image to Docker Hub, and gh release create publishes a release that the Hub indexes. Check the repo visibility and tag before you approve. github.com

  • aws s3 rm and sync can remove files in your volume

    The AWS reference shows rm and sync against a network volume. Check the path and the volume id first. github.com

  • Setup guides run installers and sudo

    The GitHub CLI guide uses sudo apt commands and the Hugging Face guide offers curl -LsSf https://hf.co/cli/install.sh | bash. Read each command and prefer brew where you can. github.com

  • The plugin route installs all 16 skills and the Runpod MCP config

    The marketplace file lists 16 skills for the runpod plugin. It also bundles .mcp.json, which registers the hosted Runpod MCP server at mcp.runpod.io, and a /runpod:migrate command. The git tree shows no hooks file in the plugin folder. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Talks tohuggingface.co and hf.co. github.com. Docker Hub. s3api-<datacenter>.runpod.io (Runpod S3 API)
Sign-in and keysEach CLI keeps its own credentials (for example hf auth login, gh auth login, ~/.aws/credentials). SKILL.md says S3 API keys are created only in the Runpod console, and to ask you when they are missing.
Scopes
  • Runs hf, gh, docker and aws commands

  • Uses tokens for Hugging Face, GitHub, Docker Hub and Runpod S3

  • Can generate an SSH key (ssh-keygen -t ed25519) and register it with gh ssh-key add

  • The setup guides include installer commands, some with sudo

Questions

What does the companion-clis skill do?

It tells your coding agent how to use the hf, gh, docker and aws command line tools for Runpod work: downloading models, building and pushing images, publishing releases and moving files to network volumes.

How do I install companion-clis?

Use the install box at the top of this page. The four CLIs install separately, per task, from the setup guides in the skill.

Does it need API keys?

Yes, one set per CLI: a Hugging Face login or token, a GitHub login, a Docker Hub personal access token, and Runpod S3 keys that you create in the Runpod console.

Is companion-clis safe?

It can push images, publish releases and change files on your volumes. Approve each of those, and use tokens with the narrowest scope that works.

Why does the AWS CLI need a Runpod endpoint?

Runpod exposes network volumes through its own S3-compatible API, not AWS. SKILL.md says the access key is your Runpod user id, the secret is an S3 API key, and every command needs a data center region and endpoint URL.

Is this the official Runpod skill?

Yes. It is in Runpod's own runpod-plugins-official repo, and the plugin manifest names Runpod as author.

Does it work in the Claude app or Codex?

The README documents Claude Code and Codex plugins, plus the skills CLI for other agents. The skill runs local command line tools, so there is no Claude app upload option here.

Information

updated Nov 2, 2026

Folder
plugins/runpod/skills/companion-clis

runpod/runpod-plugins-officialskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6
  1. README.md · github.com
  2. marketplace.json · github.com
  3. SKILL.md · github.com
  4. aws.md · github.com
  5. github-setup.md · github.com
  6. README.md · github.com

Updated Nov 2, 2026.