Claude Codex Settings

Battle-tested Claude Code, Claude Desktop, OpenAI Codex, and Cursor setup with skills, commands, hooks, subagents, and MCP servers, plus Kimi, MiniMax, and GLM API support.

"They make wrong assumptions on your behalf and just run along with them without checking. They don't manage their confusion, they don't seek clarifications, they don't surface inconsistencies, they don't present tradeoffs. They really like to overcomplicate code and APIs, they bloat abstractions, they don't clean up dead code after themselves." -- Andrej Karpathy

This repo's guidelines are structured to fix exactly these pitfalls.

Installation • Plugins • Configuration • References

Installation

Plugins add skills, commands, and automations to your AI coding tool. Install only what you need from the plugin list below.

Prerequisites: See INSTALL.md for setup requirements.

# Add marketplace (one time)
claude plugin marketplace add fcakyon/claude-codex-settings

# Install any plugin by name
claude plugin install fable-advisor@claude-settings

# Add marketplace (one time)
codex plugin marketplace add fcakyon/claude-codex-settings

# Install any plugin by name
codex plugin add simplify@claude-settings

# Install any plugin by name
gemini extensions install --path ./plugins/simplify

# Install any plugin by name
cursor plugin install simplify@claude-settings

Create symlinks for cross-tool compatibility:

ln -sfn CLAUDE.md AGENTS.md
ln -sfn CLAUDE.md GEMINI.md

Plugins

Run /simplify to review your staged or committed diff across four angles (reuse, simplification, efficiency, altitude) with parallel agents, then apply the cleanups. It reviews changed-code quality, not correctness bugs. It brings Claude Code's built-in /simplify to Codex, Cursor, and Gemini, which don't ship it natively, so all three get the same review and apply flow.

Skills:

• simplify - review the changed diff across four angles and apply the fixes

Before a Write or Edit saves, humanize scans the new text and blocks whatever reads like a machine wrote it, each hit paired with a plain-word swap. It reads markdown files whole and, in code, only the comments and docstrings, never the code:

• 3 marks: the em-dash, section sign, and stray semicolon (the en-dash stays)
• 53 stock words like leverage, seamlessly, vibrant, game-changing, each mapped to a plain swap
• 16 openers and cliches like in conclusion, a testament to, aims to bridge
• 10 pile-up words like crucial or significant, flagged at 3+ uses in one write

Runs on Claude Code and Gemini. Unlike a markdown rule the model can ignore, the hook checks every Write or Edit and blocks each match until it is replaced. The word list draws on Wikipedia's "Signs of AI writing".

Hooks:

• humanize.py - blocks matched marks, buzzwords, and cliches before a Write or Edit lands

Ask a Fable 5 reviewer to challenge a plan or conclusion before you commit, a drop-in for the built-in advisor when the Opus-main plus Fable-advisor pairing fails with a bare "unavailable" (#73365). Claude Code uses a native Fable agent with the recent conversation attached. Codex, Cursor, and Gemini call the same model through an authenticated Claude Code CLI with claude -p --model fable.

Agents:

• fable-advisor - Native Claude Code reviewer with recent conversation context

Skills:

• fable-advisor - Routes Claude Code to its native agent and other tools to claude -p

Cuts filler and keeps output token use down with the answer or next step first, one-action-per-step lists, concrete time estimates, a single under-two-minute next action, and short teaching notes while coding. Claude Code applies the output style automatically. Codex, Cursor, and Gemini CLI expose the same instructions as an adhd-output-style skill because they do not support plugin output styles.

Output styles:

• ADHD Explanatory - Low-token ADHD formatting plus educational Insight blocks while coding

Skills:

• adhd-output-style - Apply the same reply format in Codex, Cursor, and Gemini CLI

When Claude Code auto-summarizes a long session, the default summary routinely drops the highest-signal facts. This plugin tells the summarizer to keep them:

• File paths under investigation so the next turn doesn't re-discover where you were
• Confirmed root causes so you don't re-debug what's already solved
• Open questions, metrics, and IDs that prose summaries usually round away
• Findings from expensive subagent runs that took minutes to gather

Runs on every /compact (manual) and every auto compaction. Claude Code only; Codex, Cursor, and Gemini CLI don't yet expose a comparable summary hook.

Hooks:

• precompact_priorities.sh - Priority-preservation instructions for the compaction summarizer

Adds the two missing pieces Claude Code's telemetry needs to power a usage dashboard:

• Sticky session ID per project: resumed conversations stay one session, not dozens
• Categorized rejection reasons (profanity, wrong target, scope drift, retry, and more): chart why Claude pushes back

Per-device data is already in Claude Code's built-in OpenTelemetry stream. Pairs naturally with openobserve-skills for the dashboard side.

Hooks:

• session_start_chat_id.py - SessionStart hook that emits a sticky per-project chat_id
• user_prompt_reject_feedback.py - UserPromptSubmit hook that categorizes tool-rejection reasons

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/anthropic-office-skills --skill '*'

Official office document skills from anthropics/skills.

Skill	Description	Install
pdf	PDF processing (read, merge, split, create, OCR, forms)
pptx	PowerPoint presentation building and editing
xlsx	Excel spreadsheet processing with formulas
docx	Word document creation and editing

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/openai-office-skills --skill '*'

Office document skills for creating and editing PDFs, Word documents, slide decks, and spreadsheets.

Skill	Description	Install
pdf	PDF generation and extraction with visual review
slides	Slide deck creation with PptxGenJS
spreadsheet	Spreadsheet processing with formulas and formatting
doc	Word document creation and editing

Python coding guidelines grounded in authoritative sources: PEP 8, PEP 20 (Zen of Python), Google Python Style Guide, and Brett Slatkin's "Effective Python" (3rd ed.). Covers code integration, idiomatic patterns, YAGNI anti-abstraction rules, Google-style docstrings, and 18 before/after code examples.

Skills:

Reference files:

• zen-of-python.md - Full PEP 20 with annotations
• google-style-guide.md - Curated sections with source URLs
• idiomatic-patterns.md - 18 patterns with before/after code
• effective-python-tips.md - Key tips from 3rd edition

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/react-skills --skill '*'

React and frontend best practices from vercel-labs/agent-skills.

Skills (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

Skill	Description	ZIP
composition-patterns	React composition patterns: compound components, render props, context
react-best-practices	64 React/Next.js performance rules from Vercel Engineering
react-native-skills	35+ React Native/Expo rules for performance and animations
react-view-transitions	View Transition API for page/route animations
web-design-guidelines	UI review against 16 web interface guideline categories

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/agent-browser --skill '*'

Browser automation via CLI instead of MCP. 93% less context usage than Playwright MCP by using snapshot + element refs instead of full DOM tree dumps. From vercel-labs/agent-browser.

Skills (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

Skill	Description	ZIP
agent-browser	Browser automation: navigation, forms, clicking, screenshots, auth, sessions
electron	Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion)

CLI Tool: agent-browser - install via npm i -g agent-browser && agent-browser install

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/frontend-design-skills --skill '*'

Frontend design skills from anthropics/claude-plugins-official and openai/plugins.

Skill	Description	Install
openai-frontend-design	Composition-first design: restrained layout, image-led hierarchy, tasteful motion
anthropic-frontend-design	Bold aesthetic direction, distinctive typography, anti-generic AI aesthetics

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/mongodb-skills --skill '*'

Official MongoDB agent skills for schema design, query tuning, Atlas Search, and connections. From mongodb/agent-skills.

Skills (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

Skill	Description	ZIP
mongodb-atlas-stream-processing	Atlas stream processing patterns
mongodb-connection	Connection management
mongodb-mcp-setup	MCP server setup
mongodb-natural-language-querying	Natural language to queries
mongodb-query-optimizer	Query performance tuning
mongodb-schema-design	Schema design patterns
mongodb-search-and-ai	Atlas Search and AI integration

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/supabase-skills --skill '*'

Supabase skills covering Postgres query/schema best practices from supabase/agent-skills, JavaScript SDK usage from supabase/supabase-js, and CLI workflows from supabase/cli.

Skills (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

Skill	Description	ZIP
supabase-postgres-best-practices	Postgres performance and schema design across 8 categories
supabase-js	JavaScript SDK for auth, database, storage, realtime, edge functions
supabase-cli	CLI for local dev, migrations, edge functions, project management

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/stripe-skills --skill '*'

Official Stripe agent skills for payment integration: API selection, Connect platform setup, billing/subscriptions, Treasury, and SDK upgrades. From stripe/ai.

Skills (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

Skill	Description	ZIP
stripe-best-practices	Payments, billing, Connect, Treasury integration best practices
stripe-projects	Stripe Projects CLI setup and stack provisioning
upgrade-stripe	Stripe API version and SDK upgrade