Fix agent setup for non-Claude agents; point product feedback at report_feedback

[lukepiette]

Why

Agent feedback collected Sep 9 to Oct 13 (≈300 reports through the Runpod MCP) showed the "Install for other agents" path on /agent-setup failing or misleading agents. #889 fixed the skill list. This PR fixes what's still broken.

Changes to agent-setup.mdx

• Skills install: add --agent <agent-id> plus an id table taken from the skills CLI (1.7.2). Without --agent, --yes --global targets every known agent and prints Failed to install N for PromptScript, which agents read as a total failure (6 reports, 2 from today). Also adds the Node 22.20 requirement (from skills engines) and a skills list --global verify step.
• Codex: codex plugin add runpod@runpod replaces the UI-only /plugins user step. The fallback is now codex mcp add runpod --url …, since --transport is no longer a Codex CLI flag (4 reports). Adds a note to restart Codex Desktop.
• Other agents: the page used to send every other agent to npx @runpod/mcp-server@latest add. That's a TTY-only wizard that exits 0 without writing config in an agent shell, and it only supports Claude Code, Cursor, Windsurf, Claude Desktop and VS Code (6 reports, including opencode and Pi). Agents now register the hosted URL directly (Gemini and Pi commands; a config entry for the rest), and the wizard becomes a User step.
• Verify: explain what an empty Pod list on a funded account means: OAuth signed in to a different account.
• No hard-coded skill counts, since the number keeps changing. The banner now reads "router + lane + journey skills".
• Small additions: a note on blocked GitHub (misleading SSH known_hosts error); Codex, opencode and Cline doc links.

Feedback routing (agent-setup.mdx + docs.json)

Docs feedback stays on the docs MCP's submit_feedback. Both the new page section and one added sentence in the global markdown.instructions now say that product or Runpod MCP tool problems go to report_feedback on https://mcp.getrunpod.io/. Agents were mixing the two up (5 reports).

Depends on

runpod/runpod-plugins-official#83, which marks the two contributor skills internal. Until it merges, --skill '*' installs 2 extra contributor skills. Merge #83 first.

Testing

• mint validate: build validation passed.
• mint broken-links: identical output to main (the 8 existing broken links are all on the globalvolume pages; none are new).
• node scripts/validate-tooltips.js and node scripts/validate-redirect-sources.js pass.
• Vale: warnings only, no errors, same categories as the current page.
• Rendered locally with mint dev: the agent-id table, code blocks and banner display correctly.
• Commands: the install line with --skill '*' --agent codex was run against the Update runpodctl reference docs to 1.14.3 and fix MacOs install #83 branch into a throwaway HOME (15 skills, no failures). codex plugin add/codex mcp add --url were checked on codex-cli 0.153.4 and gemini mcp add locally. The Pi command comes from a user report and wasn't tested.

🤖 Generated with Claude Code

[mintlify]

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

Project	Status	Preview	Updated
runpod-docs	🟢 Ready	View Preview	Oct 13, 2026, 9:25 PM

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