Skip to content

docs: Update agent skills page for the new Runpod skills plugin#714

Merged
justinwlin merged 4 commits into
mainfrom
promptless/agent-skills-plugin-restructure
Jul 17, 2026
Merged

docs: Update agent skills page for the new Runpod skills plugin#714
justinwlin merged 4 commits into
mainfrom
promptless/agent-skills-plugin-restructure

Conversation

@promptless

@promptless promptless Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Rewrites get-started/agent-skills.mdx to reflect runpod/skills PR #31. The quick start now leads with a single universal install command (npx skills add runpod/skills), followed by CLI install and one-key authentication. A new "Getting started" section adds an easy first-use workflow: verify the install, then drive tools in plain English (example prompts). Per-agent native installs (Claude Code /plugin, Codex, Gemini) and MCP-server connection move to a secondary "Native install options" section. Keeps the What's included table (router plus six skills), update, and uninstall steps.

Trigger Events


Tip: Point @Promptless at some of your docs debt and have it clean them up in the background 🧹

```

Restart your agent after installation.
Next, install the Runpod CLI that the skills rely on (skip this if you already have it):

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rewrote the intro and ## What's included table from PR #31's root README.md and plugins/runpod/README.md, which restructure runpod/skills into a single installable plugin: a runpod router that hands off to the runpod-mcp, runpodctl, flash, companion-clis, and runpod-usage skills, backed by a bundled hosted MCP server. This replaces the page's old "two skills" (Flash and runpodctl) framing.

Source: runpod/runpod-plugins-official#31

# Set the key for the current shell (add to ~/.zshrc or ~/.bashrc to persist):
export RUNPOD_API_KEY=<key>

# Or save it permanently to ~/.runpod/config.toml:

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The per-agent install, update, and uninstall commands come from PR #31's root README.md install section: Claude Code (/plugin marketplace add runpod/skills, /plugin install runpod@runpod, /reload-plugins), Codex (codex plugin marketplace add https://github.com/runpod/skills.git and the fallback codex mcp add runpod --transport http https://mcp.getrunpod.io/), and skills.sh (npx skills add runpod/skills, plus the npx @runpod/mcp-server@latest add guided MCP installer).

Source: runpod/runpod-plugins-official#31


Install the Runpod skills package in your project:
## Quick start

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Restructured the quick start to lead with the single universal npx skills add runpod/skills command, then CLI install, one-key auth (export RUNPOD_API_KEY or runpodctl doctor), and plain-English prompts, matching the "One command — works with every agent" Quick start section of the updated README.md in PR #31.

Source: runpod/runpod-plugins-official#31

## Available skills
That's it. Restart your agent, then head to [Getting started](#getting-started) to run your first request.

## Getting started

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a beginner-friendly "Getting started" first-use workflow (verify the install by asking "List my Runpod endpoints", then drive tools in plain English), modeled on the updated README.md "Now just ask in plain English" example prompts and the Claude Code Verify step in PR #31.

Source: runpod/runpod-plugins-official#31

@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Jul 17, 2026, 12:01 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟡 Building Jul 16, 2026, 11:59 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

promptless Bot and others added 4 commits July 16, 2026 20:23
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.
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 <noreply@anthropic.com>
@justinwlin
justinwlin force-pushed the promptless/agent-skills-plugin-restructure branch from ceeb472 to 744771e Compare July 17, 2026 00:23
@justinwlin
justinwlin self-requested a review July 17, 2026 01:03
@promptless

promptless Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

Just a reminder: If you'd like me to act on any feedback you have via Github comments, just type @Promptless in your suggestion and I'll get right on it! (I won't show up in the user dropdown, but I'll process any request that has @Promptless in the comment body.)

@justinwlin
justinwlin merged commit 957eed9 into main Jul 17, 2026
3 checks passed
@justinwlin
justinwlin deleted the promptless/agent-skills-plugin-restructure branch July 17, 2026 01:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant