From c5a69a1ad92e60784b863d85bcecdb570234fdbe Mon Sep 17 00:00:00 2001 From: Mohamed Boudra Date: Sat, 4 Apr 2026 17:40:37 +0700 Subject: [PATCH] Update skill CLI examples to use --provider provider/model format Always specify the model in paseo run examples (e.g. --provider codex/gpt-5.4 instead of --provider codex) to prevent agents from launching with wrong defaults. --- skills/paseo-committee/SKILL.md | 6 +++--- skills/paseo-handoff/SKILL.md | 22 +++++++++++----------- skills/paseo-loop/SKILL.md | 10 +++++----- skills/paseo-orchestrator/SKILL.md | 14 +++++++------- skills/paseo/SKILL.md | 26 ++++++++++++-------------- 5 files changed, 38 insertions(+), 40 deletions(-) diff --git a/skills/paseo-committee/SKILL.md b/skills/paseo-committee/SKILL.md index 9d8a96f12..1c3035c18 100644 --- a/skills/paseo-committee/SKILL.md +++ b/skills/paseo-committee/SKILL.md @@ -77,8 +77,8 @@ $NO_EDITS" Same prompt to both, `[Committee]` prefix for identification: ```bash -opus_id=$(paseo run -d --mode bypassPermissions --model opus --thinking on --name "[Committee] Task description" "$prompt" -q) -gpt_id=$(paseo run -d --mode full-access --provider codex --model gpt-5.4 --thinking medium --name "[Committee] Task description" "$prompt" -q) +opus_id=$(paseo run -d --mode bypassPermissions --provider claude/opus --thinking on --name "[Committee] Task description" "$prompt" -q) +gpt_id=$(paseo run -d --mode full-access --provider codex/gpt-5.4 --thinking medium --name "[Committee] Task description" "$prompt" -q) ``` ### Wait for both @@ -129,7 +129,7 @@ paseo send "$gpt_id" "Merged plan: [plan]. Concerns? $NO_EDITS" Implement the plan yourself — unless the user said **"delegate"**, in which case launch an implementer: ```bash -impl_id=$(paseo run -d --mode full-access --provider codex --name "[Impl] Task description" "Implement the following plan end-to-end. [plan]" -q) +impl_id=$(paseo run -d --mode full-access --provider codex/gpt-5.4 --name "[Impl] Task description" "Implement the following plan end-to-end. [plan]" -q) paseo wait "$impl_id" ``` diff --git a/skills/paseo-handoff/SKILL.md b/skills/paseo-handoff/SKILL.md index 3e889d4ff..7919335eb 100644 --- a/skills/paseo-handoff/SKILL.md +++ b/skills/paseo-handoff/SKILL.md @@ -30,13 +30,13 @@ Parse `$ARGUMENTS` to determine: ### Provider Resolution -| User says | Provider | Model | Mode | -|---|---|---|---| -| *(nothing)* | `codex` | `gpt-5.4` | `full-access` | -| `codex` | `codex` | `gpt-5.4` | `full-access` | -| `claude` | `claude` | `opus` | `bypass` | -| `opus` | `claude` | `opus` | `bypass` | -| `sonnet` | `claude` | `sonnet` | `bypass` | +| User says | --provider | Mode | +|---|---|---| +| *(nothing)* | `codex/gpt-5.4` | `full-access` | +| `codex` | `codex/gpt-5.4` | `full-access` | +| `claude` | `claude/opus` | `bypass` | +| `opus` | `claude/opus` | `bypass` | +| `sonnet` | `claude/sonnet` | `bypass` | Default is **Codex** with `gpt-5.4`. @@ -109,27 +109,27 @@ This is the critical step. The receiving agent has **zero context** about your c ### Default (Codex, no worktree) ```bash -paseo run -d --mode full-access --provider codex --name "[Handoff] Task description" "$prompt" +paseo run -d --mode full-access --provider codex/gpt-5.4 --name "[Handoff] Task description" "$prompt" ``` ### Claude (Opus, no worktree) ```bash -paseo run -d --mode bypassPermissions --model opus --name "[Handoff] Task description" "$prompt" +paseo run -d --mode bypassPermissions --provider claude/opus --name "[Handoff] Task description" "$prompt" ``` ### Codex in a worktree ```bash base=$(git branch --show-current) -paseo run -d --mode full-access --provider codex --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt" +paseo run -d --mode full-access --provider codex/gpt-5.4 --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt" ``` ### Claude in a worktree ```bash base=$(git branch --show-current) -paseo run -d --mode bypass --model opus --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt" +paseo run -d --mode bypass --provider claude/opus --worktree task-branch-name --base "$base" --name "[Handoff] Task description" "$prompt" ``` ## After Launch diff --git a/skills/paseo-loop/SKILL.md b/skills/paseo-loop/SKILL.md index ae51fb10c..d383c79b1 100644 --- a/skills/paseo-loop/SKILL.md +++ b/skills/paseo-loop/SKILL.md @@ -39,8 +39,8 @@ Every loop needs at least one form of verification: Choose the right provider/model for worker and verifier independently: -- `--provider`/`--model` — sets the worker's provider and model -- `--verify-provider`/`--verify-model` — sets the verifier's provider and model +- `--provider ` — sets the worker (e.g. `codex/gpt-5.4`) +- `--verify-provider ` — sets the verifier (e.g. `claude/opus`) Default: both use Claude/sonnet. For implementation loops, use Codex for the worker and Claude for the verifier — each catches the other's blind spots. @@ -64,7 +64,7 @@ paseo loop run "Check PR #42. Review CI, comments, and branch status. Fix issues ```bash paseo loop run "Run the test suite, investigate failures, and fix the code." \ - --provider codex \ + --provider codex/gpt-5.4 \ --verify "Run the test suite. Return done=true only if all tests pass. Cite the exact command and outcome." \ --verify-check "npm test" \ --max-iterations 10 \ @@ -75,9 +75,9 @@ paseo loop run "Run the test suite, investigate failures, and fix the code." \ ```bash paseo loop run "Implement issue #456. Make incremental progress each iteration." \ - --provider codex \ + --provider codex/gpt-5.4 \ --verify "Verify issue #456 is complete. Check changed files, run typecheck and tests." \ - --verify-provider claude --verify-model sonnet \ + --verify-provider claude/sonnet \ --max-iterations 8 \ --max-time 2h \ --archive \ diff --git a/skills/paseo-orchestrator/SKILL.md b/skills/paseo-orchestrator/SKILL.md index a246675bb..cce817d93 100644 --- a/skills/paseo-orchestrator/SKILL.md +++ b/skills/paseo-orchestrator/SKILL.md @@ -78,7 +78,7 @@ Launch agents with lightweight initial prompts. Each agent gets: ### Initial prompt template ```bash -paseo run -d --mode full-access --provider codex \ +paseo run -d --mode full-access --provider codex/gpt-5.4 \ --name "impl-" \ "You are an implementation engineer on a team. @@ -114,10 +114,10 @@ Pick the right provider for each role: | Role | Provider | Why | |---|---|---| -| Implementation | `codex` / `gpt-5.4` | Thorough, methodical, good at deep implementation | -| Review / Audit | `claude` / `opus` | Good design instinct, catches over-engineering | -| Investigation | `claude` / `opus` | Strong reasoning, good at tracing code paths | -| Planning | `claude` / `opus` with `--thinking on` | Extended thinking for complex problems | +| Implementation | `--provider codex/gpt-5.4` | Thorough, methodical, good at deep implementation | +| Review / Audit | `--provider claude/opus` | Good design instinct, catches over-engineering | +| Investigation | `--provider claude/opus` | Strong reasoning, good at tracing code paths | +| Planning | `--provider claude/opus --thinking on` | Extended thinking for complex problems | Cross-provider review: Codex implements → Claude reviews. Claude implements → Codex reviews. Each catches the other's blind spots. @@ -179,7 +179,7 @@ paseo stop # (archiving happens automatically if the agent was part of a loop with --archive) # Launch a fresh one -paseo run -d --mode full-access --provider codex \ +paseo run -d --mode full-access --provider codex/gpt-5.4 \ --name "impl--v2" \ "You are picking up work from a previous agent. Load the paseo-chat skill. Read room '' from the beginning to catch up on the full history — the objective, what was done, what went wrong. Introduce yourself and continue from where the previous agent left off. @mention when you've caught up." -q ``` @@ -191,7 +191,7 @@ The chat room has the full history. The new agent reads it and continues. After implementation is done, launch a review agent (opposite provider): ```bash -paseo run -d --mode bypassPermissions --model opus \ +paseo run -d --mode bypassPermissions --provider claude/opus \ --name "review-" \ "You are a reviewer on a team. Load the paseo-chat skill. Read room '' to understand the objective and what was implemented. diff --git a/skills/paseo/SKILL.md b/skills/paseo/SKILL.md index 1ac7355f2..312e5916d 100644 --- a/skills/paseo/SKILL.md +++ b/skills/paseo/SKILL.md @@ -14,8 +14,8 @@ paseo ls --json # JSON output for parsing # Create and run an agent (blocks until completion by default, no timeout) paseo run --mode bypassPermissions "" paseo run --mode bypassPermissions --name "task-name" "" -paseo run --mode bypassPermissions --model opus "" -paseo run --mode full-access --provider codex "" +paseo run --mode bypassPermissions --provider claude/opus "" +paseo run --mode full-access --provider codex/gpt-5.4 "" # Wait timeout - limit how long run blocks (default: no limit) paseo run --wait-timeout 30m "" # Wait up to 30 minutes @@ -86,10 +86,8 @@ paseo loop run "" [options] --sleep # Delay between iterations (30s, 5m) --max-iterations # Maximum number of iterations --max-time # Maximum total runtime (1h, 30m) - --provider # Worker agent provider (claude, codex) - --model # Worker agent model - --verify-provider # Verifier agent provider - --verify-model # Verifier agent model + --provider # Worker agent provider/model (e.g. codex/gpt-5.4) + --verify-provider # Verifier agent provider/model (e.g. claude/opus) --archive # Archive agents after each iteration # Manage loops @@ -209,18 +207,18 @@ paseo terminal kill "$id" ## Available Models -**Claude (default provider)** — use aliases, CLI resolves to latest version: -- `--model haiku` — Fast/cheap, ONLY for tests (not for real work) -- `--model sonnet` — Default, good for most tasks -- `--model opus` — For harder reasoning, complex debugging +**Claude (default provider):** +- `--provider claude/haiku` — Fast/cheap, ONLY for tests (not for real work) +- `--provider claude/sonnet` — Good for most tasks +- `--provider claude/opus` — For harder reasoning, complex debugging -**Codex** (`--provider codex`): -- `--model gpt-5.4` — Latest frontier agentic coding model (default, preferred for all engineering tasks) -- `--model gpt-5.1-codex-mini` — Cheaper, faster, but less capable +**Codex:** +- `--provider codex/gpt-5.4` — Latest frontier agentic coding model (preferred for all engineering tasks) +- `--provider codex/gpt-5.1-codex-mini` — Cheaper, faster, but less capable ## Permissions -Always launch agents fully permissioned. Use `--mode bypassPermissions` for Claude and `--mode full-access` for Codex. Control behavior through **strict prompting**, not permission modes. +Always launch agents fully permissioned. Use `--mode bypassPermissions` for Claude and `--mode full-access` for Codex. Always specify the model: `--provider claude/opus`, `--provider codex/gpt-5.4`, etc. Control behavior through **strict prompting**, not permission modes. ## Waiting for Agents