ask-codex

Route repository tasks between Claude Code and Codex with delegation modes.

9|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/bookSiYi1412/ask-codex --skill ask-codex-booksiyi1412
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-codex
Source: https://github.com/bookSiYi1412/ask-codex/tree/main
Command: npx skills add https://github.com/bookSiYi1412/ask-codex --skill ask-codex-booksiyi1412

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires codex, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Claude Code often needs to delegate heavyweight repo-bound tasks to Codex, and this skill provides a structured framework to route, monitor, and verify those tasks while keeping Claude Code in control.

Core Features & Use Cases

  • Codex-first delegation for repo exploration, data/log inspection, validation-heavy shell tasks, and multi-file implementations.
  • Support for one-shot (A) and brokered (F) collaboration modes, with session management, progress feedback, and takeover protocols.
  • Built-in verification gates, failure-recovery, and cross-review options to ensure high-quality deliverables.

Quick Start

Describe your heavy repository task and delegate it to Codex with ask-codex using one-shot mode and entry-point files.

Frequently Asked Questions about ask-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I delegate repo exploration and data inspection tasks from Claude Code to Codex?

Delegating repo exploration and data inspection tasks to Codex requires a Codex-first routing framework using one-shot mode, enforcing self-contained prompts with explicit entry points and structured outputs. This ensures Claude Code remains in control while routing heavy repository-bound work to Codex for execution.

What is brokered collaboration mode for long-running shell tasks in Codex?

Brokered collaboration mode is a framework for managing long-running shell tasks in Codex with session management, progress feedback, and takeover protocols. It allows Claude Code to monitor delegated work through progress visibility and step in when needed, ensuring reliable deliveries for complex multi-file implementations.

Do I need Codex and jq installed to route repository work between Claude Code and Codex?

Yes, you need Codex and jq installed as dependencies to route repository work between Claude Code and Codex. These tools provide the foundational execution environment and JSON processing capabilities required for structured outputs, verification gates, and robust failure handling during delegated tasks.

How do verification gates work when delegating validation-heavy shell tasks to Codex?

Verification gates work by enforcing check-points during delegated validation-heavy shell tasks in Codex, ensuring high-quality deliverables through built-in failure-recovery and cross-review options. They validate structured outputs before completion, allowing Claude Code to verify results and handle robust failure scenarios.

What's the best way to handle multi-file implementations delegated to Codex from Claude Code?

The best way to handle multi-file implementations delegated to Codex is using a structured delegation framework with one-shot or brokered modes, enforcing self-contained prompts with explicit entry points. This approach provides progress visibility, verification gates, and takeover paths for reliable, controlled deliveries.

When should I not use one-shot delegation for repo-bound tasks in Codex?

One-shot delegation should not be used for long-running repo-bound tasks in Codex when continuous monitoring is required. Instead, use brokered collaboration mode with session management, progress feedback, and takeover protocols to maintain control and ensure robust failure handling during extended operations.