Sandbox
@fcakyon/claude-codex-settings

Plugins, hooks, and agent rules for Claude Code and Codex

This repo packages a shared setup for agent-led coding across several tools. You get installable plugins for review, writing style, advisors, telemetry, and office/document skills, along with the config files those tools read. The same guidance can be reused through `CLAUDE.md`, `AGENTS.md`, and `GEMINI.md` so the tools stay aligned.

1,140 stars108 forksPythonUpdated 7d ago
Who it's for

Builders who want one reusable setup for Claude Code, Codex, Cursor, and Gemini CLI.

What it delivers

You can keep your agent workflow, review habits, and project guidance consistent across tools instead of rewriting them for each one.

What it does

Shared project guidance

`CLAUDE.md`, `AGENTS.md`, and `GEMINI.md` let you point multiple tools at the same rules file.

Code review and cleanup plugin

`simplify` reviews staged or committed diffs for reuse, redundancy, efficiency, and abstraction, then applies fixes.

Writing guard hook

`humanize` blocks AI-sounding buzzwords, cliches, and punctuation patterns before writes land.

Advisor plugins

`fable-advisor` and `codex-advisor` ask another model to challenge a plan before you commit to it.

Office document skills

`anthropic-office-skills` and `openai-office-skills` add PDF, Word, PowerPoint, and spreadsheet workflows.

Telemetry and compaction hooks

`claude-telemetry-hooks` adds session and rejection tracking, and `intelligent-compact` preserves key context during summaries.

How to get it

  1. 1Prerequisites: 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
  2. 2In Claude Code desktop, select + beside the prompt, then Plugins and Add plugin.
    # Add marketplace (one time)
    codex plugin marketplace add fcakyon/claude-codex-settings
    
    # Install any plugin by name
    codex plugin add simplify@claude-settings
  3. 3In the Codex desktop app, open Plugins, find the plugin, and select Install.
    # Install any plugin by name
    gemini extensions install --path ./plugins/simplify
  4. 4Run
    # Add marketplace (one time)
    cursor-agent plugin marketplace add https://github.com/fcakyon/claude-codex-settings
    
    # Start the interactive CLI
    cursor-agent
  5. 5Want the shared agent guidance too? .claude/CLAUDE.md is the file written for your…
    ln -sfn CLAUDE.md AGENTS.md # Codex CLI, Cursor, Copilot
    ln -sfn CLAUDE.md GEMINI.md # Gemini CLI

README

Claude Codex Settings Logo

Mentioned in Awesome Claude Code Claude Code Codex CLI Cursor Context7 MCP llms.txt

Downloads Views

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.

InstallationPluginsConfigurationReferences

Claude Settings has setup guides and skill downloads. Agent Plugins is the compact plugin directory.

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.

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

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

In Claude Code desktop, select + beside the prompt, then Plugins and Add plugin.

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

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

In the Codex desktop app, open Plugins, find the plugin, and select Install.

Gemini CLI
# Install any plugin by name
gemini extensions install --path ./plugins/simplify
Cursor
# Add marketplace (one time)
cursor-agent plugin marketplace add https://github.com/fcakyon/claude-codex-settings

# Start the interactive CLI
cursor-agent

Enter /plugin, open the marketplace, and install the plugin at user or project scope. In the Cursor app, open Customize and select Install.

Want the shared agent guidance too? .claude/CLAUDE.md is the file written for your projects. Run /claude-tools:sync-claude-md to pull it into ~/.claude/CLAUDE.md, or paste it into a project as CLAUDE.md, then point the other tools at the same file:

ln -sfn CLAUDE.md AGENTS.md # Codex CLI, Cursor, Copilot
ln -sfn CLAUDE.md GEMINI.md # Gemini CLI

Plugins

simplify - Review changed code for reuse, redundancy, and over-engineering, then apply fixes
Claude CodeCodex CLIGemini CLI
claude plugin install simplify@claude-settingscodex plugin add simplify@claude-settingsgemini extensions install --path ./plugins/simplify

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

Hooks:

  • guard.py - Require a completed /simplify run before each Claude Code or Codex commit, unless you explicitly ask to skip it for one commit
humanize - Block a curated list of AI buzzwords on every write with a hook
Claude CodeCodex CLIGemini CLI
claude plugin install humanize@claude-settingscodex plugin add humanize@claude-settingsgemini extensions install --path ./plugins/humanize

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 checks comments and docstrings in code files while skipping source code and recognized code-shaped references:

  • 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".

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

SkillDescriptionZIP
humanizeAvoid common AI writing patterns with examplesZIP

Hooks:

  • humanize.py - blocks matched marks, buzzwords, and cliches before a Write or Edit lands
fable-advisor - Get a second opinion from Claude Fable 5 before big decisions
Claude CodeCodex CLIGemini CLI
claude plugin install fable-advisor@claude-settingscodex plugin add fable-advisor@claude-settingsgemini extensions install --path ./plugins/fable-advisor

Ask a Fable 5 reviewer to challenge a plan or conclusion before you commit. Claude Code now supports Fable through its built-in advisor, while 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
codex-advisor - Get a second opinion from GPT via Codex CLI before big decisions
Claude CodeCodex CLIGemini CLI
claude plugin install codex-advisor@claude-settingscodex plugin add codex-advisor@claude-settingsgemini extensions install --path ./plugins/codex-advisor

Ask GPT to challenge a plan before you build it, the cross-model check the built-in advisor cannot give you. Claude Code attaches the recent conversation, so "ask the codex advisor" is enough. Codex, Cursor, and Gemini reach the same reviewer. Needs the Codex CLI signed in.

Agents:

  • codex-advisor - Sends the recent conversation to GPT and returns the verdict verbatim

Skills:

  • codex-advisor - Routes Claude Code to its native agent and other tools to codex exec
adhd-output-style - Use fewer output tokens with short steps, quick insights, and clear next actions
Claude CodeCodex CLIGemini CLI
claude plugin install adhd-output-style@claude-settingscodex plugin add adhd-output-style@claude-settingsgemini extensions install --path ./plugins/adhd-output-style

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 (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

SkillDescriptionZIP
adhd-output-styleApply the same reply format in Codex, Cursor, and Gemini CLIZIP
intelligent-compact - Keep file paths, root causes, and open questions through auto-summaries
Claude CodeCodex CLIGemini CLI
claude plugin install intelligent-compact@claude-settingscodex plugin add intelligent-compact@claude-settingsgemini extensions install --path ./plugins/intelligent-compact

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:

claude-telemetry-hooks - Track Claude Code usage, rejections, and session stats in one dashboard
Claude CodeCodex CLIGemini CLI
claude plugin install claude-telemetry-hooks@claude-settingsn/agemini extensions install --path ./plugins/claude-telemetry-hooks

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:

anthropic-office-skills - Official Anthropic PDF, Word, PowerPoint, Excel skills
Claude CodeCodex CLIGemini CLI
claude plugin install anthropic-office-skills@claude-settingscodex plugin add anthropic-office-skills@claude-settingsgemini extensions install --path ./plugins/anthropic-office-skills

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.

SkillDescriptionInstall
pdfPDF processing (read, merge, split, create, OCR, forms)ZIP
pptxPowerPoint presentation building and editingZIP
xlsxExcel spreadsheet processing with formulasZIP
docxWord document creation and editingZIP
openai-office-skills - Official OpenAI PDF, Word, PowerPoint, Excel skills
Claude CodeCodex CLIGemini CLI
claude plugin install openai-office-skills@claude-settingscodex plugin add openai-office-skills@claude-settingsgemini extensions install --path ./plugins/openai-office-skills

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.

SkillDescriptionInstall
pdfPDF generation and extraction with visual reviewZIP
slidesSlide deck creation with PptxGenJSZIP
spreadsheetSpreadsheet processing with formulas and formattingZIP
docWord document creation and editingZIP
python-skills - Python best practices from PEP 8, Zen of Python, Google style, and Effective Python
Claude CodeCodex CLIGemini CLI
claude plugin install python-skills@claude-settingscodex plugin add python-skills@claude-settingsgemini extensions install --path ./plugins/python-skills

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 (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

SkillDescriptionZIP
python-guidelinesCore rules, self-tests, and reference indexZIP

Reference files:

Files in the repo

Repository payload20 top-level entries
  • .agents
  • .claude
  • .claude-plugin
  • .codex
  • .cursor-plugin
  • .github
  • .vscode
  • plugins
  • site
  • .gitignore
  • AGENTS.md
  • CLAUDE.md
  • context7.json
  • GEMINI.md
  • INSTALL.md
  • LICENSE
  • README.md
  • ruff.toml
  • wrangler.agentplugins.jsonc
  • wrangler.claudesettings.jsonc

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More plugins

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

138k
1 add

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

82k
code-yeongyu/
oh-my-openagent

OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph engineering.

69k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

94k

Opinionated Oxlint rules for rejecting low-evidence TypeScript and JavaScript patterns

4.3k