From prr
First-time setup wizard for PRR. Configures workspace path, Jira credentials, and agent defaults.
How this skill is triggered — by the user, by Claude, or both
Slash command
/prr:prr-setupThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run the PRR setup wizard to configure your environment interactively.
Run the PRR setup wizard to configure your environment interactively.
Read ~/.prr/config.yml if it exists. Note the current values — they will be shown as defaults in each prompt. If the file does not exist, use these defaults:
| Field | Default |
|---|---|
workspace_path | ~/.prr/workspace |
agents | ["claude"] |
claude_timeout | 600 |
codex_timeout | 900 |
gemini_timeout | 300 |
opencode_timeout | 900 |
gemini_model | gemini-2.5-flash |
arbiter_rounds | 3 |
google_cloud_project | fuga-prod |
google_cloud_location | europe-west4 |
jira_base_url | (empty) |
jira_email | (empty) |
jira_api_token | (empty) |
Use the AskUserQuestion tool to ask for each of the following, one at a time. Show the current/default value so the user can press Enter to keep it.
Ask in this order:
workspace_path)google_cloud_project)google_cloud_location)jira_base_url)jira_email)jira_api_token)For each answer:
Create the directory ~/.prr if needed (via mkdir -p ~/.prr), then write the YAML config to ~/.prr/config.yml using the Write tool. The format must be:
workspace_path: <value>
agents:
- <agent1>
- <agent2>
claude_timeout: 600
codex_timeout: 900
gemini_timeout: 300
opencode_timeout: 900
gemini_model: gemini-2.5-flash
arbiter_rounds: 3
google_cloud_project: <value>
google_cloud_location: <value>
jira_base_url: <value>
jira_email: <value>
jira_api_token: <value>
Omit jira fields if the user left them blank (do not write empty strings).
PRR subagents need Write and Bash permissions to the workspace. Add these to the user's Claude Code settings so they're auto-approved during reviews.
$CLAUDE_CONFIG_DIR/settings.json if CLAUDE_CONFIG_DIR is set, otherwise ~/.claude/settings.json.{"permissions":{"allow":[]}} if it doesn't exist).permissions.allow if not already present:
"Write(~/.prr/**)" — allows agents to write review files"Bash(*)" — allows agents to run codex/gemini/opencode CLIs, git commands, and testsRead back ~/.prr/config.yml and show the user a summary, then inform them:
Config saved to
~/.prr/config.yml. This file contains your workspace path, agent list, timeouts, and Jira credentials (including your API token in plaintext). Keep this file private — do not commit it to any repository.Review data (cloned repos, diffs, agent reviews, reports) is stored under your workspace path.
If opencode is in the agents list, tell the user:
The
opencodeagent readsOPENAI_API_KEYfrom your shell environment — PRR does not store it. Make sure you have one of the following:
export OPENAI_API_KEY=sk-...in your shell rc (e.g.,~/.zshrc), or- You have logged in with
opencode auth.Without auth, the opencode reviewer will fail its health check and be skipped automatically.
If gemini is in the agents list, the existing GOOGLE_CLOUD_PROJECT/LOCATION values in the config will be passed to the gemini CLI — no extra shell setup is required.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub cfactolerin/prr --plugin prr