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
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
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
- Windows: choose the shell, then set up WSL2 if needed
- HuggingFace CLI
- GitHub CLI
- Docker
- AWS CLI
Key facts
- Author
- Runpod (vendor's own repo; the marketplace file and plugin manifest name Runpod as owner and author)
- 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 ·
dockerRead 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 guidesPick 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 to | huggingface.co and hf.co. github.com. Docker Hub. s3api-<datacenter>.runpod.io (Runpod S3 API) |
|---|---|
| Sign-in and keys | Each 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 |
|
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
- Repository
- runpod/runpod-plugins-official
- Folder
plugins/runpod/skills/companion-clis
Sources
Docs, issue trackers and discussions this page is built from.
Show all 6Hide
- README.md · github.com
- marketplace.json · github.com
- SKILL.md · github.com
- aws.md · github.com
- github-setup.md · github.com
- README.md · github.com