agentmods.dev

skill-codex CLAUDE.md

Project instructions for skill-codex, a bridge that lets Claude Code ask OpenAI Codex to review code, perform tasks, or provide advice. It also describes the bridge’s commands, automatic review hook, setup, and coding conventions.

In plain words
What is it for?
Use it when developing, reviewing, testing, or extending the skill-codex project across Windows, macOS, and Linux.
Why use it?
It gives contributors one agreed description of how the project works and how its code should be written and tested.

Instructions file

5 1mo ago A scan 729 tokens original MIT
View the source file Arystos/skill-codex
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/arystos/skill-codex/claude-md
Clone the repo
git clone --depth 1 https://github.com/Arystos/skill-codex
Per session 729 This file is loaded in full into every session.
When invoked 729 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00729 $0.00729
Opus 5 $0.00365 $0.00365
Sonnet 5 $0.00146 $0.00146
Haiku 4.5 $0.00073 $0.00073

Measured 2d ago against content hash b6405ac5d989, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

skill-codex CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

- Mock `child_process.spawn` for runner tests
CLAUDE.md · 70 lines

How it starts

The opening of the file, as written. The whole thing — 70 lines — stays where its author put it; the contents beside it link to each section on GitHub.

skill-codex

Cross-platform Claude Code skill integrating OpenAI Codex CLI for code review, task delegation, and consultation.

Architecture

  • MCP Server (src/): One-direction bridge -- Claude Code calls Codex via codex exec CLI
  • Slash Commands (commands/): /codex-review, /codex-do, /codex-consult
  • Auto-review Hook (hooks/): PostToolUse hook with smart diff filtering
  • Setup CLI (setup/): npx skill-codex setup one-command installer

Key Design Decisions

  • Subscription-first: Works with codex login (ChatGPT Plus/Codex subscription). No OPENAI_API_KEY required.
  • Codex as peer, not authority: Claude critically evaluates all Codex output. Findings are suggestions, not directives.
  • Cross-platform: Windows (git-bash), macOS, Linux. Uses shell: false with resolved binary path + windowsHide: true on Windows.
  • Single MCP tool (codex_exec): Mode param controls behavior (exec vs full-auto).

Code Conventions

  • TypeScript strict mode, ES2022 target, Node16 modules
  • Immutable data patterns -- never mutate, return new objects
  • Small focused files: 50-150 lines typical, 400 max
  • Typed errors with retryable boolean on BridgeError base class
  • All magic numbers in src/config/constants.ts
  • Cross-platform paths via src/config/paths.ts and src/util/platform.ts

Testing

  • Framework: vitest
  • Target: 80%+ overall, 90%+ on runner and guards
  • Mock child_process.spawn for runner tests
  • Mock which for binary check tests
  • Use temp dirs for lock file tests

Build & Run

npm install
npm run build
npm test

MCP Server

The server exposes one tool: codex_exec with params:

  • prompt (string, required)
  • mode ("exec" | "full-auto", default "exec")
  • cwd (string, optional)
  • timeoutMs (number, optional)
  • requireGit (boolean, optional)

Environment Variables

Variable Default Description
SKILL_CODEX_TIMEOUT_MS 600000 (10 min) Subprocess timeout
SKILL_CODEX_MAX_RETRIES 3 Retry count for transient errors
SKILL_CODEX_DEBUG -- Enable debug logging to stderr
SKILL_CODEX_DEPTH 0 Recursion depth (set automatically)
SKILL_CODEX_WINDOWS_SANDBOX unelevated Windows windows.sandbox mode; works around elevated-sandbox spawn failures (codex#24098)

Read the full file on GitHub · 70 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 70 lines · 729 tokens per session scan A b6405ac5d989

Subscribe to this mod's changes

skill-codex CLAUDE.md is an instructions file published in the GitHub repository Arystos/skill-codex (5 stars, last pushed 1mo ago), licensed MIT. It adds 729 tokens to every session, about $0.0036 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Code reviewPlanningTestingai-codinganthropicclaude-codecodexcross-platform
Related

Other instructions, from other repositories

flutter-agentic-starter CLAUDE.md

Instructions for tsnAnh/flutter-agentic-starter, covering claude.md, role & responsibilities, workflows, karpathy guidelines and hard development rules.

tsnAnh/flutter-agentic-starter · 2,054 tokens

flutter-agentic-starter AGENTS.md

Instructions for tsnAnh/flutter-agentic-starter, covering agents.md, project overview, role & responsibilities, workflows and development principles.

tsnAnh/flutter-agentic-starter · 1,661 tokens

AgentDock AGENTS.md

Instructions for Cailiang/AgentDock, a project described as: Beginner-friendly desktop hub for AI coding clients, providers, Skills and MCP | 面向普通用户的 AI 编程客户端管理工具.

Cailiang/AgentDock · 287 tokens

aider-desk AGENTS.md

AGENTS.md instructions for hotovo/aider-desk, covering agents.md, common commands, development, type checking and linting and formatting.

hotovo/aider-desk · 1,725 tokens

Meta_Kim CLAUDE.md

Instructions for KimYx0207/Meta_Kim, covering metakim for claude code, fast read, what this repository is, claude code's role and canonical vs runtime files.

KimYx0207/Meta_Kim · 4,985 tokens

moonproxy-desktop AGENTS.md

Instructions for MoonProxyHQ/moonproxy-desktop, covering moonproxy, 功能, 技术栈, 目录结构 and 配置与数据存储.

MoonProxyHQ/moonproxy-desktop · 3,883 tokens