Claude Codex Settings
Sensible default Claude Code configuration focused on Python and ML projects — includes rules for type hints, docstrings, pytest patterns, and data science conventions.
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 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)
/plugin marketplace add fcakyon/claude-codex-settings
# Install any plugin by name
/plugin install < plugin-name > @claude-settings
Codex CLI
Codex installs plugins from a local marketplace rather than a direct shell install command.
- Clone this repo locally and open it in Codex.
- This repo already includes
.agents/plugins/marketplace.json. - If Codex was already open when you added or changed that file, restart Codex.
- In Codex, open
/plugins. - Choose
Claude & Codex Settingsand install the plugins you want.
This README only covers installing this marketplace. For generic Codex marketplace examples and maintainer docs, see CLAUDE.md.
Gemini CLI
gemini extensions install --path ./plugins/<plugin-name>
Cursor
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
intelligent-compact - Stop Claude Code from forgetting file paths, root causes, and open questions when it auto-summarizes long sessions
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install intelligent-compact@claude-settings | Open /plugins -> Claude & Codex Settings -> install intelligent-compact | gemini 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:
precompact_priorities.sh- Priority-preservation instructions for the compaction summarizer
claude-telemetry-hooks - Track per-device Claude Code usage, rejection reasons, and per-session stats from a single dashboard
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install claude-telemetry-hooks@claude-settings | n/a | gemini 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:
session_start_chat_id.py- SessionStart hook that emits a sticky per-projectchat_iduser_prompt_reject_feedback.py- UserPromptSubmit hook that categorizes tool-rejection reasons
anthropic-office-skills - Official Anthropic PDF, Word, PowerPoint, Excel skills
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install anthropic-office-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install anthropic-office-skills | gemini 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.
openai-office-skills - Official OpenAI PDF, Word, PowerPoint, Excel skills
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install openai-office-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install openai-office-skills | gemini 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 '*'
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-skills - Python best practices from PEP 8, Zen of Python, Google Style Guide, Effective Python
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install python-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install python-skills | gemini 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:
| Skill | Description |
|---|---|
python-guidelines | Core rules, self-tests, and reference index |
Reference files:
zen-of-python.md- Full PEP 20 with annotationsgoogle-style-guide.md- Curated sections with source URLsidiomatic-patterns.md- 18 patterns with before/after codeeffective-python-tips.md- Key tips from 3rd edition
react-skills - Official React, Next.js, and React Native best practices
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install react-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install react-skills | gemini extensions install --path ./plugins/react-skills |
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 |
agent-browser - Official browser automation CLI for AI agents
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install agent-browser@claude-settings | Open /plugins -> Claude & Codex Settings -> install agent-browser | gemini extensions install --path ./plugins/agent-browser |
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
frontend-design-skills - Official frontend design skills (Anthropic + OpenAI)
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install frontend-design-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install frontend-design-skills | gemini extensions install --path ./plugins/frontend-design-skills |
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 |
mongodb-skills - Official MongoDB agent skills for schema design, query tuning, and Atlas Search
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install mongodb-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install mongodb-skills | gemini extensions install --path ./plugins/mongodb-skills |
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 |
supabase-skills - Supabase Postgres best practices, JavaScript SDK, and CLI skills
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install supabase-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install supabase-skills | gemini extensions install --path ./plugins/supabase-skills |
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 |
stripe-skills - Official Stripe agent skills for payments, billing, Connect, and API upgrades
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install stripe-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install stripe-skills | gemini extensions install --path ./plugins/stripe-skills |
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 |
polar-skills - Official Polar agent skills for billing, subscriptions, and local dev environment
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install polar-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install polar-skills | gemini extensions install --path ./plugins/polar-skills |
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 |
livekit-skills - LiveKit voice AI agent development (Cloud + self-hosted)
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install livekit-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install livekit-skills | gemini extensions install --path ./plugins/livekit-skills |
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 |
cloudflare-skills - Official Cloudflare developer platform skill for Workers, R2, D1, KV, AI, and 50+ services
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install cloudflare-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install cloudflare-skills | gemini extensions install --path ./plugins/cloudflare-skills |
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 |
web-performance-skills - Web performance auditing with Core Web Vitals, Lighthouse, and Chrome DevTools
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install web-performance-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install web-performance-skills | gemini extensions install --path ./plugins/web-performance-skills |
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 |
openobserve-skills - OpenObserve REST API skill for AI agents to search logs/metrics/traces and create dashboards via curl
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install openobserve-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install openobserve-skills | gemini extensions install --path ./plugins/openobserve-skills |
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
customQueryre-aggregation bug that doubles table rows whenfields.ycarries anaggregationFunction
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 |
hetzner-skills - Hetzner Cloud CLI skill for servers, networks, firewalls, load balancers, DNS, and storage
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install hetzner-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install hetzner-skills | gemini extensions install --path ./plugins/hetzner-skills |
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 |
dokploy-skills - Dokploy deployment skill for Dokploy Cloud and self-hosted dashboards
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install dokploy-skills@claude-settings | Open /plugins -> Claude & Codex Settings -> install dokploy-skills | gemini extensions install --path ./plugins/dokploy-skills |
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 |
anthropic-essentials - Feature dev, CLAUDE.md management, skill creation
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 codebaseskill-creator- Create, improve, and benchmark Agent Skills with eval testing
Agents:
code-architect- Architecture design from codebase patternscode-explorer- Deep codebase exploration and analysiscode-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 changesSessionEnd(prompt) - Remind to capture learnings when session ends
anthropic-plugin-dev - Plugin development toolkit
Act
More Configs
Awesome CLAUDE.md
A curated collection of CLAUDE.md configuration files from real projects — monorepos, SaaS apps, open-source libraries, and enterprise codebases.
Claude Code System Prompts
Curated CLAUDE.md system prompt variations for different coding styles and strictness levels — conservative, balanced, and aggressive modes with detailed trade-off notes.
CLAUDE.md Templates
Ready-to-use CLAUDE.md templates for popular stacks: Next.js, Django, Rails, FastAPI, Spring Boot, and more — with tech-specific rules and conventions.