Skip to content

docs: simplify agent setup prompt - #749

Merged
camopod merged 1 commit into
mainfrom
cameronmcclendon/agent-setup-simplify
Jul 31, 2026
Merged

docs: simplify agent setup prompt#749
camopod merged 1 commit into
mainfrom
cameronmcclendon/agent-setup-simplify

Conversation

@camopod

@camopod camopod commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Replaces the published agent setup prompt at https://docs.runpod.io/agent-setup.md with a revised, simplified version. Same page, same URL.

What changed

  • Scoped setup down to skills + MCP server. The runpodctl install, Flash SDK install, and API key steps are gone. The skills install those on demand the first time a task needs them, so doing it up front is wasted work.
  • Made the agent/user split explicit. The prompt now says up front that the agent runs the commands itself, marks the only two User step items (in-session commands, OAuth sign-in), and tells it never to run a command that blocks on an interactive prompt.
  • Added a verification step for Claude Code (claude plugin list, expected status, how to recover if disabled).
  • Replaced the all-green completion banner with a status banner that distinguishes verified (), needs a user action (), and failed (). The old version printed success for the MCP server before the user had signed in.
  • Noted that every command is safe to re-run on a machine where setup already happened.

Notes

  • Page is standalone, not in docs.json navigation, and nothing else in the repo links to it, so no nav or link updates are needed.
  • No tooltip imports; scripts/validate-tooltips.js passes.

🤖 Generated with Claude Code

Narrow the setup prompt to what an agent should actually do in one shot:
install the skills and MCP server, then report only what it verified.

- Drop the CLI and Flash SDK install plus the API key steps. The skills
  install those on demand the first time a task needs them.
- State up front that the agent runs the commands itself, and mark the
  two user-only steps (in-session commands, OAuth sign-in) explicitly.
- Add a plugin verification command for Claude Code.
- Replace the all-green completion banner with a status banner that
  distinguishes verified, needs-user-action, and failed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 30, 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 30, 2026, 9:07 PM

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

@camopod
camopod merged commit a5d69f5 into main Jul 31, 2026
3 checks passed
@camopod
camopod deleted the cameronmcclendon/agent-setup-simplify branch July 31, 2026 13:53
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.

2 participants