{"id":51181373,"url":"https://github.com/amelnagdy/delegate-skills","last_synced_at":"2026-06-27T07:03:05.997Z","repository":{"id":366771187,"uuid":"1269124956","full_name":"amElnagdy/delegate-skills","owner":"amElnagdy","description":"Drive the OpenAI Codex CLI as a background implementer, brief it, review its diff, land the commit yourself.","archived":false,"fork":false,"pushed_at":"2026-06-23T07:40:59.000Z","size":31,"stargazers_count":122,"open_issues_count":2,"forks_count":19,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-06-23T09:24:20.320Z","etag":null,"topics":["agent-skills","automation","claude-code","coding-agent","developer-tools","openai-codex","skills-cli"],"latest_commit_sha":null,"homepage":"https://www.skills.sh/amelnagdy/delegate-skills","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amElnagdy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-14T10:35:48.000Z","updated_at":"2026-06-23T07:41:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/amElnagdy/delegate-skills","commit_stats":null,"previous_names":["amelnagdy/delegate-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/amElnagdy/delegate-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amElnagdy%2Fdelegate-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amElnagdy%2Fdelegate-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amElnagdy%2Fdelegate-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amElnagdy%2Fdelegate-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amElnagdy","download_url":"https://codeload.github.com/amElnagdy/delegate-skills/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amElnagdy%2Fdelegate-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34844350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","automation","claude-code","coding-agent","developer-tools","openai-codex","skills-cli"],"created_at":"2026-06-27T07:03:03.724Z","updated_at":"2026-06-27T07:03:05.988Z","avatar_url":"https://github.com/amElnagdy.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# delegate-skills\n\n[![skills.sh](https://skills.sh/b/amElnagdy/delegate-skills)](https://skills.sh/amElnagdy/delegate-skills)\n\nSkills for **delegating coding work to a separate CLI agent and landing it yourself**. Your agent (the\norchestrator) writes a self-contained brief, hands it to an implementer CLI, then reviews the diff and\ncommits — staying the reviewer the whole way.\n\nThe first skill, **`codex-delegate`**, drives the OpenAI Codex CLI.\n\n## Install\n\nBrowse first:\n\n```bash\nnpx skills add amElnagdy/delegate-skills --list\n```\n\nInstall the package, or just one skill:\n\n```bash\nnpx skills add amElnagdy/delegate-skills\nnpx skills add amElnagdy/delegate-skills --skill codex-delegate\n```\n\nInstall for a specific agent, or globally:\n\n```bash\nnpx skills add amElnagdy/delegate-skills --skill codex-delegate --agent claude-code\nnpx skills add amElnagdy/delegate-skills --global\n```\n\nWorks with any orchestrating agent the [Skills CLI](https://github.com/vercel-labs/skills) supports.\n\n## What it does\n\nThe loop, for `codex-delegate`:\n\n1. **Write a brief** — a self-contained task spec; Codex sees only what you send.\n2. **Dispatch** it with the bundled `relay.mjs` (a thin `codex exec` wrapper).\n3. **Wait** for completion — the helper writes a structured `result.json`.\n4. **Review** the diff — re-run the project's gates yourself; pair with [guard skills](https://github.com/amElnagdy/guard-skills).\n5. **Land** it — *you* commit, because the implementer's sandbox can't reliably write `.git`.\n\n```text\nUse $codex-delegate to have Codex implement the refactor in services/billing/, then review and commit it.\nUse $codex-delegate to run this queue of migration tasks through Codex while I review each one.\n```\n\n## How this differs from the OpenAI Codex plugin\n\nThe official openai-codex Claude Code plugin is excellent and\n**complementary** — this skill builds on the same `codex` CLI, it doesn't replace the plugin. They\npoint in different directions:\n\n- The plugin's `codex:codex-rescue` agent is a **forwarder**: it hands one task to Codex and returns\n  the output. It deliberately does not poll, review, or commit.\n- The plugin's review command and stop-review gate run the **inverse** direction: **Codex reviews your work**.\n- `codex-delegate` is the **orchestration loop in the other direction**: *you* drive Codex to\n  implement across one task or a queue, and *you* review and land each result. That loop — brief →\n  dispatch → poll → review → commit, with the orchestrator owning the commit — is what the plugin\n  leaves to you, and what this skill encodes.\n\nIf you have the plugin installed, its companion CLI is an optional alternative dispatch backend; the\nbundled `relay.mjs` is the default because it needs nothing but the `codex` binary.\n\n## The skills\n\n### codex-delegate\n\nDrive the OpenAI Codex CLI as a background implementer: write the brief, dispatch via `relay.mjs`,\nreview the diff, commit it yourself. Ships four references (writing the brief, dispatch/poll, review/\nland, multi-task queues) loaded only when needed, and one small helper script.\n\n**You'll feel it when:** a bounded task — a migration, a mechanical refactor, a removal sweep — gets\nhanded to Codex, comes back as a clean diff with a structured report, and you commit it after re-running\nthe gates yourself instead of typing it all by hand.\n\n### gemini-delegate\n\n*Planned.* A delegate skill for the Gemini CLI, if and when it gains a comparable non-interactive mode.\nReserved so the umbrella can grow without a rename.\n\n## Requirements\n\n- The [`codex` CLI](https://github.com/openai/codex) installed and authenticated (`codex login`).\n- Node 18+ and `git`.\n- An orchestrating agent that can run shell commands and read files.\n- Shell examples assume bash/zsh (macOS/Linux, or Git Bash/WSL on Windows).\n\n## Trust and validation\n\nThis package is intentionally inspectable:\n\n- All skill content is Markdown, plus exactly **one** executable: `skills/codex-delegate/scripts/relay.mjs`.\n- `relay.mjs` itself makes no network calls, reads or writes no credentials, sends no telemetry, and\n  has no dependencies (Node built-ins only). It shells out only to `codex` and `git`. The `codex`\n  process it launches authenticates exactly as you do at the terminal. Read the script before you run it.\n- It never commits — committing is always the orchestrator's job, after review.\n\n**Verification status:** the relay's `codex` integration (flags, exit codes, `result.json`) is verified;\nthe end-to-end loop is designed for and run on Claude Code, but not yet formally verified across a full\ndelegate → review → commit cycle. Other orchestrators (OpenCode, Cursor, …) are designed-for but\nunproven. This line gets upgraded to \"verified end-to-end\" with evidence, not assumption.\n\n## Repository shape\n\n```text\nskills/\n└── codex-delegate/\n    ├── SKILL.md\n    ├── scripts/relay.mjs\n    └── references/\n        ├── writing-the-brief.md\n        ├── dispatch-and-poll.md\n        ├── review-and-land.md\n        └── multi-task-queues.md\n```\n\nThe `SKILL.md` stays small so it loads cheaply; the references load only when the task needs them.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famelnagdy%2Fdelegate-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famelnagdy%2Fdelegate-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famelnagdy%2Fdelegate-skills/lists"}