swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/assets/codex-skills/phone-opus/SKILL.md
blob: 5fe91d78295229a9460eb65de7ac6c00b6a63d42 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
---
name: phone-opus
description: Use when you want a consultative Claude Code pass through the local `phone_opus` MCP server. Trigger for blocking second-opinion analysis, repository inspection, summaries, or planning where Claude should have read-only built-in tools but no edit capability.
---

# phone-opus

Use `phone_opus.consult` when you want a blocking Claude Code consult without edit permissions.

## When to use it

Whenever you're making a *major, nontrivial, high level* design decision, you should get a second opinion from Opus.
Opus is intelligent and has a different perspective, so takes its feedback seriously; but nothing it says
should be taken as authoritative or final. It is a pure consultant.

- Ask for a second opinion on code, architecture, debugging, or design.
- Point Claude at a specific repository with `cwd`.
- Cap the consultation with `max_turns` when needed.
- Reuse `session_id` from an earlier call when you want Claude to continue the same conversation.

## Tool surface

- `consult`
  - required: `prompt`
  - optional: `cwd`, `max_turns`, `session_id`, `render`, `detail`
- `health_snapshot`
- `telemetry_snapshot`

## Runtime posture

- Uses `--permission-mode dontAsk`, so only globally preapproved read-only Bash commands can execute.
- This surface is consultative only. Edit tools are unavailable.
- The returned `session_id` is reusable: pass it back into a later `consult` call to continue that Claude conversation.

## Example

Call `phone_opus.consult` with:

- `prompt`: `Inspect the Rust workspace and tell me where the retry logic is brittle.`
- `cwd`: `/absolute/path/to/repo`
- `max_turns`: `6`

Expect a blocking response containing Claude's answer plus execution metadata such as duration, turn count, session id, and cost when available.