swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/assets
diff options
context:
space:
mode:
Diffstat (limited to 'assets')
-rw-r--r--assets/codex-skills/phone-opus/SKILL.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/assets/codex-skills/phone-opus/SKILL.md b/assets/codex-skills/phone-opus/SKILL.md
new file mode 100644
index 0000000..481cd4a
--- /dev/null
+++ b/assets/codex-skills/phone-opus/SKILL.md
@@ -0,0 +1,42 @@
+---
+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
+
+- 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.
+
+## Tool surface
+
+- `consult`
+ - required: `prompt`
+ - optional: `cwd`, `max_turns`, `render`, `detail`
+- `health_snapshot`
+- `telemetry_snapshot`
+
+## Runtime posture
+
+- Uses the system `claude` install.
+- Runs with default Claude settings.
+- Exposes no MCP servers to Claude.
+- Restricts Claude to the read-only built-in toolset:
+ - `Bash,Read,Grep,Glob,LS,WebFetch,WebSearch`
+- Uses `--permission-mode dontAsk`, so only globally preapproved read-only Bash commands can execute.
+- This surface is consultative only. Edit tools are unavailable.
+
+## 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.