claude-code

Claude Code CLI Delegation for Agent's Shell Tool

This skill is written for shell tool. Assume there is no PTY. Do not use the interactive Claude TUI.

Selection Policy

Codex is preferred for programming delegation. Before invoking Claude Code, check whether Codex can handle the task:

if command -v codex >/dev/null 2>&1 && codex login status >/dev/null 2>&1; then
  echo "Prefer the codex skill for this coding task."
elif command -v claude >/dev/null 2>&1; then
  claude --version
  claude auth status --text
else
  echo "Neither codex nor claude is installed; continue directly or ask the user to install one."
fi

Use Claude Code when:

• codex is not installed or not authenticated.
• Codex failed on a task where a second coding agent is useful.
• The user explicitly asks for Claude Code.
• The repo or task is already configured around Claude Code conventions.

If claude auth status --text fails, ask the user to run claude auth login, claude auth login --console, or configure ANTHROPIC_API_KEY. Do not start an interactive login flow from the agent.

Non-Interactive Rules

• Use claude -p for every delegated task.
• Do not run bare claude, claude "query", tmux, slash commands, /review, /compact, interactive permission flows, or anything that waits for keyboard input.
• Do not use --tmux, -w --tmux, or any other PTY orchestration.
• Pass the task through stdin or a carefully quoted prompt. Stdin is safer for long task descriptions.
• Set --max-turns so the agent cannot run indefinitely.
• Use --allowedTools to make non-interactive tool use explicit. Keep tools narrower for review-only work.
• Avoid --dangerously-skip-permissions unless the user explicitly approves a fully trusted run.

Preflight Checklist

Before delegating:

1. Identify the project root: git rev-parse --show-toplevel 2>/dev/null || pwd.
2. Check git status --short and preserve unrelated user changes.
3. Turn the user's request into clear success criteria, constraints, and verification commands.
4. Choose the tool list: broad for implementation, read-only for review.
5. Prefer Codex if it is available and authenticated.