claude-ui
Installation
SKILL.md
When this skill is used:
- Treat the user's exact request as the UI task to delegate.
- Require the user to explicitly choose both a Claude model and a reasoning effort before running anything.
- Use the invoking agent's structured user-input or selection tool to collect those choices when that tool exists in the current harness or mode.
- Do not ask for model or effort in plain text if the structured tool is available. USE YOUR USER INPUT TOOL TO ASK FOR THE MODEL AND EFFORT!
- If the structured tool is unavailable, ask the user directly in plain text and do not proceed until both values are provided.
- Do not add extra repository context unless it is necessary. Claude Code can inspect the repository itself.
- Run the bundled helper script outside the Codex sandbox so Claude Code can use the user's existing local auth:
bun run .agents/skills/claude-ui/src/run-claude-ui.ts --model "<model>" --effort "<effort>" -- "<user request>"
- While the helper is running, prefer observation over intervention. Inspect the helper state and outputs rather than taking over the task.
- Do not interrupt, replace, or second-guess the delegated Claude run just because it is slow.
- Only intervene if there is a concrete failure such as a non-zero exit, an auth failure, a permission or tool error, or a clearly exceeded timeout.
- If intervention is needed, preserve any partial work already produced and explain briefly why intervention was necessary.
- Wait for Claude Code to finish.
- Inspect the resulting changes with:
git status --shortgit diff --stat
- Summarize what changed.
- If no files changed, say so clearly.
Rules:
- The helper script must run in the current Codex workspace or worktree.
- Run the helper command with escalated permissions so it can access the user's normal Claude CLI login context.
- The skill must not run until both
--modeland--efforthave been explicitly selected. - Prefer the harness selection/input tool over plain-text questioning whenever that tool is available.
- Check what models and effort values are available before asking, rather than relying on a hard-coded list in this skill.
- Once the helper script starts, the invoking agent's role is to monitor, inspect, verify, and summarize. Claude should remain the implementer unless there is a concrete failure.
- Do not try to convert Claude output into a fake Codex event format.
- Prefer direct in-place file edits so the Codex app can show the Git diff naturally.
- Keep the change minimal and focused on the user's request.