claude codex settings

My daily battle-tested Claude Code/Desktop and OpenAI Codex setup with skills, commands, hooks, subagents and MCP servers.

"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)
/plugin marketplace add fcakyon/claude-codex-settings

# Install any plugin by name
/plugin install < plugin-name > @claude-settings

Codex installs plugins from a local marketplace rather than a direct shell install command.

1. Clone this repo locally and open it in Codex.
2. This repo already includes .agents/plugins/marketplace.json.
3. If Codex was already open when you added or changed that file, restart Codex.
4. In Codex, open /plugins.
5. Choose Claude & Codex Settings and install the plugins you want.

This README only covers installing this marketplace. For generic Codex marketplace examples and maintainer docs, see CLAUDE.md.

gemini extensions install --path ./plugins/<plugin-name>

cursor plugin install < plugin-name > @claude-settings

Create symlinks for cross-tool compatibility:

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

Plugins

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 '*'

Official office document skills from openai/skills.

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/skills.

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
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 guide

Skills CLI

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

Official Polar agent skills for billing system, Stripe integration, subscription lifecycle, and local dev with Docker. From polarsource/polar.

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

Skill	Description	ZIP
polar-billing	Polar billing system, Stripe integration, subscriptions, benefit provisioning
polar-local-environment	Polar local development environment with Docker

Skills CLI

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

Voice AI agent development with the LiveKit Agents SDK. Cloud-agnostic: supports both LiveKit Cloud and self-hosted deployments. Uses lk CLI for docs access instead of MCP. Based on livekit/agent-skills, patched for CLI workflow and BYOK model providers.

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

Skill	Description	ZIP
livekit-skills	Voice AI agents: architecture, handoffs, testing, CLI workflow

Skills CLI

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

Cloudflare developer platform skill with decision trees for product selection across Workers, Durable Objects, R2, D1, KV, Workers AI, and 50+ services. From cloudflare/skills.

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

Skill	Description	ZIP
cloudflare-deploy	Cloudflare platform: compute, storage, AI, networking, security

Skills CLI

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

Audit web page performance using Chrome DevTools MCP. Measures Core Web Vitals (FCP, LCP, TBT, CLS, Speed Index), identifies render-blocking resources, network dependency chains, layout shifts, caching issues, and accessibility gaps. From cloudflare/skills.

Bundles the chrome-devtools MCP server (no API key needed).

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

Skill	Description	ZIP
web-performance-optimization	Core Web Vitals, Lighthouse, render-blocking, accessibility audits

Skills CLI

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

Programmatic access to OpenObserve (Cloud or self-hosted) via the documented REST API. Covers:

• Auth and search: HTTP Basic auth, the search/SQL endpoint with microsecond timestamps
• Streams and dashboards: stream listing/schema, dashboard CRUD, the v8 panel JSON schema
• Known pitfalls: the customQuery re-aggregation bug that doubles table rows when fields.y carries an aggregationFunction

Built for AI agents: uses curl only, no SDK or CLI dependency. Pairs naturally with claude-telemetry-hooks for Claude Code usage dashboards. Reference docs are mirrored from openobserve/openobserve-docs.

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

Skill	Description	ZIP
openobserve-api	Search SQL, streams, dashboards, panel schema, ingestion endpoints, common pitfalls

Skills CLI

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

Hetzner Cloud infrastructure management via the hcloud CLI. Decision trees for compute, networking, storage, DNS, and common deploy workflows. Reference docs extracted from hetznercloud/cli.

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

Skill	Description	ZIP
hetzner-deploy	Servers, networks, firewalls, load balancers, DNS, volumes, storage

Skills CLI

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

Dokploy Cloud and self-hosted dashboard workflows from Dokploy/website, plus a compact CLI command index generated from Dokploy/cli.

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

Skill	Description	ZIP
dokploy-deploy	Dokploy Cloud, self-hosted dashboard, Docker Compose, databases, domains, remote servers, CLI index

Best-of bundle from anthropics/claude-plugins-official. Cherry-picks skills, agents, and commands from multiple upstream plugins.

Skills:

• claude-md-improver - Audit and improve CLAUDE.md files across a codebase
• skill-creator - Create, improve, and benchmark Agent Skills with eval testing

Agents:

• code-architect - Architecture design from codebase patterns
• code-explorer - Deep codebase exploration and analysis
• code-reviewer - Code quality and review

Commands:

• /feature-dev - Guided feature development workflow
• /revise-claude-md - Capture session learnings into CLAUDE.md

Hooks:

• Stop (prompt) - Suggest CLAUDE.md updates after significant code changes
• SessionEnd (prompt) - Remind to capture learnings when session ends

Actively maintained plugin development toolkit from anthropics/claude-plugins-official. 7 skills, 3 agents, and guided plugin creation.

Skills: hook-development, mcp-integration, plugin-structure, plugin-settings, command-development, agent-development, skill-development

Agents: agent-creator, plugin-validator, skill-reviewer

Commands: /create-plugin - Guided plugin workflow

Academic research toolkit from fcakyon/phd-skills. Experiment design, literature review, paper writing, citation verification, and reviewer defense for PhD workflows.

Skills:

• dataset-curation - Dataset preparation and annotation guidelines
• experiment-design - Experiment setup and ablation planning
• latex-setup - LaTeX project configuration
• literature-research - Literature search and review
• paper-verification - Citation and claim verification
• paper-writing - Academic paper drafting
• research-publishing - Submission and publishing workflow
• reviewer-defense - Reviewer response preparation

Agents:

• experiment-analyzer - Analyze experiment results and suggest next steps
• paper-auditor - Audit paper for consistency and completeness

Commands:

• /factcheck - Verify citations and claims
• /fortify - Strengthen paper against reviewer critiques
• /gaps - Find gaps in literature coverage
• /setup - Configure phd-skills
• /xray - Deep analysis of a paper

Skills CLI

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

Git and GitHub automation. Run the setup skill after install.

Agents:

• commit-creator - Intelligent commit workflow
• pr-creator - Pull request creation
• pr-reviewer - Code review agent
• pr-comment-resolver - PR comment resolution

Skills:

• commit-staged - Commit staged changes and write the message
• create-pr - Create a pull request from the full branch diff
• review-pr - Review a pull request for bugs and regressions
• resolve-pr-comments - Address unresolved PR review comments
• update-pr-summary - Update the PR title and description
• clean-gone-branches - Clean local branches deleted from remote
• setup - Configure GitHub CLI

Hooks:

• git_commit_confirm.py - Confirmation before git commit
• gh_pr_create_confirm.py - Confirmation before gh pr create

Auto-formatting hooks for Python, JavaScript, Markdown, and Bash.

Hooks:

• format_python_docstrings.py - Google-style docstring formatter
• python_code_quality.py - Python code quality with ruff
• prettier_formatting.py - JavaScript/TypeScript/CSS/JSON
• markdown_formatting.py - Markdown formatting
• bash_formatting.py - Bash script formatting

Skills CLI

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

40+ Azure services with Azure CLI authentication. Run /azure-tools:setup after install.

Skills:

• azure-usage - Best practices for Azure
• setup - Troubleshooting guide

Commands:

• /azure-tools:setup - Configure Azure MCP

MCP: .mcp.json | microsoft/mcp/Azure.Mcp.Server

Commands for syncing CLAUDE.md and permissions allowlist from repository, plus context refresh for long conversations.

Commands:

• /load-claude-md - Refresh context with CLAUDE.md instructions
• /sync-claude-md - Sync CLAUDE.md from GitHub
• /sync-allowlist - Sync permissions allowlist

Hooks:

• sync_marketplace_to_plugins.py - Syncs marketplace.json to plugin.json

Skills CLI

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

Logs, metrics, and traces. Run /gcloud-tools:setup after install.

Skills:

• gcloud-usage - Best practices for GCloud Logs/Metrics/Traces
• setup - Troubleshooting guide

Commands:

• /gcloud-tools:setup - Configure GCloud MCP

MCP: .mcp.json | google-cloud/observability-mcp

Skills CLI

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

Search papers across arXiv, PubMed, IEEE, Scopus, ACM. Run /paper-search-tools:setup after install. Requires Docker.

Skills:

• paper-search-usage - Best practices for paper search
• setup - Troubleshooting guide

Commands:

• /paper-search-tools:setup - Configure Paper Search MCP

MCP: .mcp.json | mcp/paper-search

Skills CLI

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

Web search and content extraction. Run /tavily-tools:setup after install.

Skills:

• tavily-usage - Best practices for Tavily Search
• setup - Troubleshooting guide

Commands:

• /tavily-tools:setup - Configure Tavily MCP

Hooks:

• webfetch_to_tavily_extract.py - Redirect WebFetch to Tavily extract
• websearch_to_tavily_search.py - Redirect WebSearch to Tavily search
• tavily_extract_to_advanced.py - Upgrade Tavily extract depth

MCP: .mcp.json | tavily-ai/tavily-mcp

Skills CLI

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

Pull reviewer comments from an Overleaf project, locate each in your local git-tracked *.tex files, and apply edits you review. Run setup once to paste your Overleaf session cookie; sessions slide ~5 days idle. Pairs naturally with github-dev for the commit step.

Skills:

• setup - Capture and refresh the Overleaf session cookie
• review-overleaf - Fetch unresolved review threads and apply edits to local .tex files

Configuration

Configuration in .claude/settings.json:

• Model: OpusPlan mode (plan: Opus 4.6, execute: Opus 4.6, fast: Sonnet 4.6) - source
• Environment: bash working directory, telemetry disabled, MCP output limits
• Permissions: bash commands, git operations, MCP tools
• Plugins: All plugins enabled

Configuration in .claude/settings-zai.json using Z.ai GLM models via Anthropic-compatible API:

• Main model: GLM-5-Turbo (dialogue, planning, coding, complex reasoning)
• Fast model: GLM-4.7-Flash (file search, syntax checking)
• Cost savings: 85% cheaper than Claude 4.6 - source
• API key: Get from z.ai/model-api

Run Claude Code with Kimi K2.5 via Anthropic-compatible API - source:

• Model: kimi-k2.5 - High-speed thinking, 256K context
• API key: Get from platform.moonshot.ai

export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN="your-moonshot-api-key"
export ANTHROPIC_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.5
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2.5
export ENABLE_TOOL_SEARCH=false

Run Claude Code with MiniMax M2.7 via Anthropic-compatible API - source:

• Model: MiniMax-M2.7 - 204K context window
• Fast model: MiniMax-M2.7-highspeed - high-throughput variant
• API key: Get from minimax.io

export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
export ANTHROPIC_AUTH_TOKEN="your-minimax-api-key"
export ANTHROPIC_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.7
export ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7-highspeed
export CLAUDE_CODE_SUBAGENT_MODEL=MiniMax-M2.7
export ENABLE_TOOL_SEARCH=false

Or use the settings file: .claude/settings-minimax.json

For Codex CLI, see the recipe at .codex/config-minimax.toml. Note that Codex requires a local Responses API proxy since MiniMax only exposes chat completions.

Configuration in ~/.codex/config.toml:

• Model: gpt-5.4 with model_reasoning_effort set to "high"
• Provider: Azure via responses API surface
• Auth: Project-specific base URL with env_key authentication

Settings in .vscode/settings.json:

• GitHub Copilot: Custom instructions for automated commit messages and PR descriptions
• Python: Ruff formatting with auto-save and format-on-save enabled
• Terminal: Cross-platform compatibility configurations

TODO

Visual demos:

• Add before/after comparison slider images or GIFs for each plugin showing the value visually

Zero-MCP goal:

• Replace MCP-based plugins with CLI alternatives where possible (mongodb, tavily, gcloud, azure, paper-search)

New plugins/skills:

• Payments: Stripe best practices, Polar billing and local dev
• Payments: Paddle billing and checkout skills
• Deployment: Cloudflare platform skill
• Deployment: Hetzner Cloud CLI skill
• Deployment: Dokploy deployment skill
• Frontend design: Anthropic + OpenAI frontend design skills (bundled as frontend-design-skills)
• Frontend: TanStack (Router, Query, Table, Form)
• Real-time: LiveKit voice/video agent skill
• Documents: Google Docs, PPTX, DOCX, Excel from OpenAI (bundled as openai-office-skills)
• Auth: Clerk, Firebase patterns
• Fullstack: FastAPI, NodeJS backends, Tailwind CSS v4, shadcn/ui, Sentry monitoring, Web Vitals
• Productivity: Caveman compressed output style saving ~75% of tokens

Static website:

• Publish agentplugins.net as a plugin catalog site with search, category filtering, per-tool install snippets, and GitHub Pages hosting

Other:

• Change marketplace and repo name to Agent Plugins instead of Claude Settings or Claude Codex Settings, and update the repo thumbnail

References

• Claude Code - Official CLI for Claude
• Claude Code Plugins - Plugin format reference
• Anthropic Skills - Official skill examples
• OpenAI Codex - Official CLI for Codex
• Codex Plugins - Plugin format reference
• Gemini CLI - Official CLI for Gemini
• Gemini Extensions - Extension format reference
• Cursor Plugins - Plugin format reference
• AGENTS.md - Cross-tool agent specification
• Agent Skills - Open format for giving agents new capabilities

Thank you for the support!