codex-delegate

Delegate background computational and file-editing tasks to the Codex CLI with file-based job tracking.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/kazukitcy/skills --skill codex-delegate-kazukitcy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-delegate
Source: https://github.com/kazukitcy/skills/tree/main/codex-delegate
Command: npx skills add https://github.com/kazukitcy/skills --skill codex-delegate-kazukitcy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the problem of managing long-running or background tasks for the Codex AI, ensuring that jobs are tracked, verified, and recoverable without manual intervention or context loss.

Core Features & Use Cases

  • Background Orchestration: Safely offload investigation, implementation, or bulk editing tasks to Codex in the background.
  • Durable Protocol: Uses a file-based job directory system to record status, stderr, and results, providing a clear audit trail for every task.
  • Failure Recovery: Includes a robust failure taxonomy and resume scripts to handle stalled jobs, mid-flight crashes, or interrupted processes.

Quick Start

Use the codex-delegate skill to launch a background task by composing a prompt file and executing the backend script with the appropriate sandbox configuration.

Frequently Asked Questions about codex-delegate

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

FAQPage Schema
How do I run background tasks with Codex without losing progress on crashes?

To run background tasks without losing progress, this skill uses a durable, file-based protocol to track job status and results. It implements a comprehensive failure taxonomy and resume scripts to automatically recover stalled jobs or interrupted processes during Codex delegation.

Can I delegate bulk file editing and code review to Codex in isolated workspaces?

Yes, you can delegate bulk mechanical edits, code reviews, and design spikes to Codex within isolated workspaces. The skill safely offloads these computational and file-editing tasks to the background while maintaining a clear audit trail for every operation.

What's the best way to orchestrate long-running Codex jobs for complex workflows?

The best way to orchestrate long-running Codex jobs is by composing a prompt file and executing the backend script with the appropriate sandbox configuration. This approach ensures complex workflows are tracked, verified, and recoverable across intermittent execution environments without manual intervention.

Do I need bash and git to use codex-delegate for background task recovery?

Yes, you need bash, git, and the codex CLI installed to use this background task delegation skill. These dependencies are required to execute the backend scripts, manage the file-based job directory system, and handle the state recovery protocol.

How does the failure taxonomy handle stalled jobs during Codex workflow orchestration?

The failure taxonomy handles stalled jobs by recording status, stderr, and results in a durable file-based job directory. This allows the system to verify task completion, classify the failure, and execute state recovery scripts to resume interrupted processes.

When should I not use background task delegation for Codex?

You should not use background task delegation for Codex if your workflow requires immediate, synchronous feedback or lacks an isolated workspace environment. The skill is designed for long-running, complex background tasks that benefit from durable tracking rather than quick, interactive commands.