From 836627703364d6a8aabbf1787be79a790f4fd289 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 16 Jul 2026 19:32:16 +0000 Subject: [PATCH 1/4] docs: Update agent skills page for the new Runpod skills plugin Reflects the runpod/skills restructure into a single installable plugin (router + skills + bundled MCP server), with install routes for Claude Code, Codex, and skills.sh, plus update/uninstall steps. --- get-started/agent-skills.mdx | 103 +++++++++++++++++++++++++++-------- 1 file changed, 79 insertions(+), 24 deletions(-) diff --git a/get-started/agent-skills.mdx b/get-started/agent-skills.mdx index 931a391d4..2b30c0b13 100644 --- a/get-started/agent-skills.mdx +++ b/get-started/agent-skills.mdx @@ -1,42 +1,86 @@ --- title: "Agent skills for AI coding tools" sidebarTitle: "Agent skills" -description: "Manage GPU workloads on Runpod with coding agents like Claude Code and Cursor." +description: "Manage GPU workloads on Runpod with coding agents like Claude Code, Codex, and Cursor." tag: "NEW" --- -Agent skills make it easier for coding agents to use Runpod directly from your editor or terminal. Once installed, you can ask your agent to create Pods, deploy Serverless endpoints, manage templates, and more, all through natural language. +The Runpod skills plugin teaches your coding agent how to run GPU workloads on Runpod. Once you install it, you can ask your agent to create Pods, deploy Serverless endpoints, transfer files, or deploy your own code with Flash, all through natural language. -These skills work with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://www.cursor.com/), [GitHub Copilot](https://github.com/features/copilot), [Windsurf](https://codeium.com/windsurf), [Cline](https://github.com/cline/cline), and [17+ other AI agents](https://skills.sh/). +The plugin ships as a single package that bundles everything your agent needs: a hosted [Runpod MCP server](/get-started/mcp-servers) for structured control-plane actions, skills that teach the agent to use `runpodctl` and Flash, conceptual knowledge about how Runpod works, and a set of worked, end-to-end reference tasks. A built-in router reads your request and hands it to the right skill, so you don't need to know which tool applies. + +It works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Cursor](https://www.cursor.com/), [GitHub Copilot](https://github.com/features/copilot), [Windsurf](https://codeium.com/windsurf), [Cline](https://github.com/cline/cline), and [many other AI agents](https://skills.sh/). + +## Requirements + +To manage resources through the plugin, you need a [Runpod API key](/get-started/api-keys). The same key authenticates the CLI, Flash, and the bundled MCP server. + +To use the `runpodctl` skill, you also need to [install the Runpod CLI](/runpodctl/overview). To use the Flash skill, you need to [install Flash](/flash/quickstart). ## Installation -Install the Runpod skills package in your project: +Choose the instructions for your agent. Each route installs the same skills and router. + +### Claude Code + +Add the marketplace, install the plugin, then reload: ```bash -npx skills add runpod/skills +/plugin marketplace add runpod/skills +/plugin install runpod@runpod +/reload-plugins +``` + +Installing the plugin also wires up the hosted Runpod MCP server. Run `/mcp`, select **runpod**, and choose **Sign in with Runpod** to authenticate. + +### Codex + +Add the marketplace from the repository URL, then install the plugin from the plugins menu: + +```bash +codex plugin marketplace add https://github.com/runpod/skills.git ``` -Restart your agent after installation. +Run `codex /plugins`, open the **Runpod** marketplace tab, and install the plugin. Reload if prompted. -If you plan to use the `runpodctl` skill, you also need to [install the Runpod CLI](/runpodctl/overview) and run the setup command to configure your [API key](/get-started/api-keys) and SSH keys: +If Runpod tools don't appear after installing, add the MCP server manually: ```bash -runpodctl doctor +codex mcp add runpod --transport http https://mcp.getrunpod.io/ ``` -## Available skills +### Cursor, Copilot, Windsurf, and other agents -The Runpod skills package includes two skills: +Install the skills through [skills.sh](https://skills.sh/): + +```bash +npx skills add runpod/skills +``` + +Restart your agent after installation. To connect the hosted MCP server, run the guided installer, which detects your agent and configures the connection: + +```bash +npx @runpod/mcp-server@latest add +``` + +## What's included + +The plugin installs a router and a set of focused skills: | Skill | Description | |-------|-------------| -| **Flash** | Build and deploy AI workloads using the `runpod-flash` SDK. Write code locally and deploy to remote GPUs/CPUs. | -| **runpodctl** | Manage GPU Pods, Serverless endpoints, templates, network volumes, and models through the Runpod CLI. | +| **runpod** | Router and entry point. Reads your task and hands it to the right skill. | +| **runpod-mcp** | Manages Pods, endpoints, templates, network volumes, registries, and billing through the Runpod MCP server. | +| **runpodctl** | Manages the same resources from the [Runpod CLI](/runpodctl/overview), plus Hub deployments, file transfers, SSH keys, and model caching. | +| **flash** | Writes and deploys your own Python code to Runpod Serverless using the [runpod-flash](/flash/overview) SDK. | +| **companion-clis** | Uses supporting CLIs such as Hugging Face, Docker, and the AWS CLI when a task needs them. | +| **runpod-usage** | Provides conceptual knowledge about Pods, Serverless, storage, and GPU selection. | + +The plugin also includes a collection of worked, end-to-end reference tasks, such as deploying a Whisper endpoint or running a model on a Pod, that guide your agent through common workflows. ## What you can do -Once installed, you can ask your AI agent to perform tasks like the following: +Once installed, you can ask your agent to perform tasks like the following: | Category | Example prompt | |----------|----------------| @@ -49,24 +93,35 @@ Once installed, you can ask your AI agent to perform tasks like the following: | Deploy with Flash | "Deploy this function to a remote GPU with Flash" | | Local development | "Start a local dev server with Flash" | -### Flash skill +## Update and uninstall -The Flash skill lets your agent use the [runpod-flash](/flash/overview) SDK to build and deploy functions to Runpod Serverless. Your agent can generate and deploy code like the following: +To update the plugin to the latest version: -```python -from runpod_flash import Endpoint, GpuGroup +```bash +# Claude Code: +/plugin marketplace update runpod + +# Codex: +codex plugin marketplace upgrade runpod -@Endpoint(name="my-worker", gpu=GpuGroup.AMPERE_80, workers=5, dependencies=["torch"]) -async def compute(data): - import torch - return {"sum": torch.tensor(data, device="cuda").sum().item()} +# skills.sh: +npx skills add runpod/skills ``` -For more details on endpoint types and configuration, see [Create endpoints with Flash](/flash/create-endpoints). +In Claude Code, run `/reload-plugins` after updating. -### runpodctl skill +To uninstall: -The runpodctl skill gives your agent access to the full [Runpod CLI](/runpodctl/overview) for managing Pods, Serverless endpoints, templates, network volumes, and file transfers. +```bash +# Claude Code: +/plugin uninstall runpod@runpod + +# Codex: +codex plugin marketplace remove runpod + +# skills.sh: +npx skills remove runpod +``` ## Learn more From a92fa987324f2852e2677eeefb6820bb798eda26 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 16 Jul 2026 20:10:31 +0000 Subject: [PATCH 2/4] Simplify agent skills quick start to one universal command --- get-started/agent-skills.mdx | 107 +++++++++++++++++++++++------------ 1 file changed, 71 insertions(+), 36 deletions(-) diff --git a/get-started/agent-skills.mdx b/get-started/agent-skills.mdx index 2b30c0b13..0b5468aca 100644 --- a/get-started/agent-skills.mdx +++ b/get-started/agent-skills.mdx @@ -11,57 +11,39 @@ The plugin ships as a single package that bundles everything your agent needs: a It works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Cursor](https://www.cursor.com/), [GitHub Copilot](https://github.com/features/copilot), [Windsurf](https://codeium.com/windsurf), [Cline](https://github.com/cline/cline), and [many other AI agents](https://skills.sh/). -## Requirements +## Quick start -To manage resources through the plugin, you need a [Runpod API key](/get-started/api-keys). The same key authenticates the CLI, Flash, and the bundled MCP server. - -To use the `runpodctl` skill, you also need to [install the Runpod CLI](/runpodctl/overview). To use the Flash skill, you need to [install Flash](/flash/quickstart). - -## Installation - -Choose the instructions for your agent. Each route installs the same skills and router. - -### Claude Code - -Add the marketplace, install the plugin, then reload: +Install the skills with a single command that works with every agent: ```bash -/plugin marketplace add runpod/skills -/plugin install runpod@runpod -/reload-plugins +npx skills add runpod/skills ``` -Installing the plugin also wires up the hosted Runpod MCP server. Run `/mcp`, select **runpod**, and choose **Sign in with Runpod** to authenticate. - -### Codex - -Add the marketplace from the repository URL, then install the plugin from the plugins menu: +Next, install the Runpod CLI that the skills rely on (skip this if you already have it): ```bash -codex plugin marketplace add https://github.com/runpod/skills.git +curl -sSL https://cli.runpod.net | bash +# or with Homebrew: +brew install runpod/runpodctl/runpodctl ``` -Run `codex /plugins`, open the **Runpod** marketplace tab, and install the plugin. Reload if prompted. - -If Runpod tools don't appear after installing, add the MCP server manually: +Then authenticate with your [Runpod API key](/get-started/api-keys). The same key works for the CLI, Flash, and the bundled MCP server: ```bash -codex mcp add runpod --transport http https://mcp.getrunpod.io/ -``` - -### Cursor, Copilot, Windsurf, and other agents +# Set the key for the current shell (add to ~/.zshrc or ~/.bashrc to persist): +export RUNPOD_API_KEY= -Install the skills through [skills.sh](https://skills.sh/): - -```bash -npx skills add runpod/skills +# Or save it permanently to ~/.runpod/config.toml: +runpodctl doctor ``` -Restart your agent after installation. To connect the hosted MCP server, run the guided installer, which detects your agent and configures the connection: +That's it. Restart your agent, then ask it to manage Runpod in plain English: -```bash -npx @runpod/mcp-server@latest add -``` +- "List my Runpod endpoints" +- "Spin up an A100 Pod" +- "Deploy this handler to Serverless" + +The router picks the right skill and drives the tools for you. If something isn't set up yet, the plugin detects it and walks you through the missing step. ## What's included @@ -93,6 +75,57 @@ Once installed, you can ask your agent to perform tasks like the following: | Deploy with Flash | "Deploy this function to a remote GPU with Flash" | | Local development | "Start a local dev server with Flash" | +## Native install options + +The `npx skills add` command above works everywhere. If you'd rather install the plugin through your agent's native marketplace, use the route for your agent below. Each route installs the same router and skills. + +### Claude Code + +Add the marketplace, install the plugin, then reload: + +```bash +/plugin marketplace add runpod/skills +/plugin install runpod@runpod +/reload-plugins +``` + +Installing the plugin also wires up the hosted Runpod MCP server. To authenticate it, run `/mcp`, select **runpod**, and choose **Sign in with Runpod**. + +### Codex + +Add the marketplace from the repository URL, then install the plugin from the plugins menu: + +```bash +codex plugin marketplace add https://github.com/runpod/skills.git +``` + +Run `codex /plugins`, open the **Runpod** marketplace tab, and install the plugin. Reload if prompted. + +If the Runpod MCP tools don't appear after installing, add the hosted MCP server manually: + +```bash +codex mcp add runpod --transport http https://mcp.getrunpod.io/ +``` + +### Gemini + +Gemini can install the plugin natively through the bundled `gemini-extension.json`. Follow your client's extension documentation to add it. + +## Connecting the MCP server on other agents + +The hosted Runpod MCP server gives your agent structured control-plane tools for managing Pods, endpoints, and other resources. Claude Code sets it up automatically during a native install. On other agents, run the guided installer, which detects your agent and configures the connection: + +```bash +npx @runpod/mcp-server@latest add +``` + +The installer authenticates the MCP server for you. To reuse the API key you already set instead, pass it as a bearer header when you add the server. For example, in Claude Code: + +```bash +claude mcp add --transport http runpod -s user https://mcp.getrunpod.io/ \ + --header "Authorization: Bearer $RUNPOD_API_KEY" +``` + ## Update and uninstall To update the plugin to the latest version: @@ -123,6 +156,8 @@ codex plugin marketplace remove runpod npx skills remove runpod ``` +If a command reports a name mismatch, list what's installed first with `/plugin marketplace list` (Claude Code), `codex plugin marketplace list` (Codex), or `npx skills list` (skills.sh), then use the name shown. + ## Learn more From 9634c70e9980fde97e62d6968e86fa89649a898a Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 16 Jul 2026 20:12:27 +0000 Subject: [PATCH 3/4] Add easy getting-started workflow after skill install --- get-started/agent-skills.mdx | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/get-started/agent-skills.mdx b/get-started/agent-skills.mdx index 0b5468aca..8e964dc63 100644 --- a/get-started/agent-skills.mdx +++ b/get-started/agent-skills.mdx @@ -37,13 +37,23 @@ export RUNPOD_API_KEY= runpodctl doctor ``` -That's it. Restart your agent, then ask it to manage Runpod in plain English: +That's it. Restart your agent, then head to [Getting started](#getting-started) to run your first request. + +## Getting started + +With the skill installed, there are no commands to memorize. The router reads your request and drives the right tool for you, so you can manage Runpod entirely in plain English. + +First, confirm the skill is available. Restart your agent, then ask it to list your resources: - "List my Runpod endpoints" + +If your agent returns your endpoints, everything is wired up. From there, describe what you want in plain language, for example: + - "Spin up an A100 Pod" - "Deploy this handler to Serverless" +- "Show my account balance" -The router picks the right skill and drives the tools for you. If something isn't set up yet, the plugin detects it and walks you through the missing step. +The router picks the right skill for each request. If something isn't set up yet, such as a missing API key or CLI, the plugin detects it and walks you through the missing step. ## What's included From 744771ecf756dc8d683b913145da5f6ca4c6c3df Mon Sep 17 00:00:00 2001 From: Justin Date: Thu, 16 Jul 2026 20:20:57 -0400 Subject: [PATCH 4/4] docs: tighten agent-skills page (remove duplication) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Concision pass on the new agent-skills page: - Drop the intro paragraph that re-described the bundle contents — the "What's included" table already covers it; keep the one-line router note. - Compress "Getting started": it repeated "the router picks the right skill" three times and duplicated the "What you can do" example prompts. Now: one verify step, then a pointer to that table. - Trim the Codex steps to the two commands + one line of guidance. No information removed — only redundant restatements. Net -14 lines. Co-Authored-By: Claude Opus 4.8 --- get-started/agent-skills.mdx | 24 +++++------------------- 1 file changed, 5 insertions(+), 19 deletions(-) diff --git a/get-started/agent-skills.mdx b/get-started/agent-skills.mdx index 8e964dc63..183f17b57 100644 --- a/get-started/agent-skills.mdx +++ b/get-started/agent-skills.mdx @@ -5,9 +5,7 @@ description: "Manage GPU workloads on Runpod with coding agents like Claude Code tag: "NEW" --- -The Runpod skills plugin teaches your coding agent how to run GPU workloads on Runpod. Once you install it, you can ask your agent to create Pods, deploy Serverless endpoints, transfer files, or deploy your own code with Flash, all through natural language. - -The plugin ships as a single package that bundles everything your agent needs: a hosted [Runpod MCP server](/get-started/mcp-servers) for structured control-plane actions, skills that teach the agent to use `runpodctl` and Flash, conceptual knowledge about how Runpod works, and a set of worked, end-to-end reference tasks. A built-in router reads your request and hands it to the right skill, so you don't need to know which tool applies. +The Runpod skills plugin teaches your coding agent how to run GPU workloads on Runpod. Once installed, you can ask your agent to create Pods, deploy Serverless endpoints, transfer files, or deploy your own code with Flash, all in natural language. A built-in router sends each request to the right skill, so you don't need to know which tool applies. It works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Cursor](https://www.cursor.com/), [GitHub Copilot](https://github.com/features/copilot), [Windsurf](https://codeium.com/windsurf), [Cline](https://github.com/cline/cline), and [many other AI agents](https://skills.sh/). @@ -37,23 +35,15 @@ export RUNPOD_API_KEY= runpodctl doctor ``` -That's it. Restart your agent, then head to [Getting started](#getting-started) to run your first request. +That's it — restart your agent and [get started](#getting-started). ## Getting started -With the skill installed, there are no commands to memorize. The router reads your request and drives the right tool for you, so you can manage Runpod entirely in plain English. - -First, confirm the skill is available. Restart your agent, then ask it to list your resources: +There are no commands to memorize: describe what you want, and the router picks the right skill (prompting you if something like an API key is still missing). Confirm it's wired up by asking: - "List my Runpod endpoints" -If your agent returns your endpoints, everything is wired up. From there, describe what you want in plain language, for example: - -- "Spin up an A100 Pod" -- "Deploy this handler to Serverless" -- "Show my account balance" - -The router picks the right skill for each request. If something isn't set up yet, such as a missing API key or CLI, the plugin detects it and walks you through the missing step. +If your endpoints come back, you're set — see [What you can do](#what-you-can-do) for more examples. ## What's included @@ -103,15 +93,11 @@ Installing the plugin also wires up the hosted Runpod MCP server. To authenticat ### Codex -Add the marketplace from the repository URL, then install the plugin from the plugins menu: - ```bash codex plugin marketplace add https://github.com/runpod/skills.git ``` -Run `codex /plugins`, open the **Runpod** marketplace tab, and install the plugin. Reload if prompted. - -If the Runpod MCP tools don't appear after installing, add the hosted MCP server manually: +Run `codex /plugins`, open the **Runpod** tab, and install (reload if prompted). If the Runpod MCP tools don't appear, add the hosted server manually: ```bash codex mcp add runpod --transport http https://mcp.getrunpod.io/