My personal Claude Code and OpenAI Codex setup with battle-tested skills, plugins, hooks and agents that I use daily.
npx skills add https://github.com/fcakyon/claude-codex-settings --skill command-developmentCLI を使用してこのスキルをインストールし、ワークスペースで SKILL.md ワークフローの使用を開始します。
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.
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.
.agents/plugins/marketplace.json./plugins.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
| 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 |
Claude Code's auto-compact summarizes long sessions to fit the context window, but the default summary routinely drops the highest-signal facts: file paths under investigation, confirmed root causes, remaining tasks, unanswered questions, metrics and IDs, and findings from expensive subagent runs. This plugin ships a single PreCompact hook that injects A-F fidelity requirements on top of the 9-section default compact prompt, so those categories survive every /compact (manual) and every auto compaction. Active on Claude Code only; Codex, Cursor, and Gemini CLI do not yet expose a PreCompact hook.
Hooks:
precompact_priorities.sh - Priority-preservation instructions for the compaction summarizer| 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.
| 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 |
| 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 |
| 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| 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 |
| 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
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
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 testingAgents:
code-architect - Architecture design from codebase patternscode-explorer - Deep codebase exploration and analysiscode-reviewer - Code quality and reviewCommands:
/feature-dev - Guided feature development workflow/revise-claude-md - Capture session learnings into CLAUDE.mdHooks:
Stop (prompt) - Suggest CLAUDE.md updates after significant code changesSessionEnd (prompt) - Remind to capture learnings when session endsActively 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 guidelinesexperiment-design - Experiment setup and ablation planninglatex-setup - LaTeX project configurationliterature-research - Literature search and reviewpaper-verification - Citation and claim verificationpaper-writing - Academic paper draftingresearch-publishing - Submission and publishing workflowreviewer-defense - Reviewer response preparationAgents:
experiment-analyzer - Analyze experiment results and suggest next stepspaper-auditor - Audit paper for consistency and completenessCommands:
/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| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install github-dev@claude-settings |
Open /plugins -> Claude & Codex Settings -> install github-dev |
gemini extensions install --path ./plugins/github-dev |
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 workflowpr-creator - Pull request creationpr-reviewer - Code review agentpr-comment-resolver - PR comment resolutionSkills:
commit-staged - Commit staged changes and write the messagecreate-pr - Create a pull request from the full branch diffreview-pr - Review a pull request for bugs and regressionsresolve-pr-comments - Address unresolved PR review commentsupdate-pr-summary - Update the PR title and descriptionclean-gone-branches - Clean local branches deleted from remotesetup - Configure GitHub CLIHooks:
git_commit_confirm.py - Confirmation before git commitgh_pr_create_confirm.py - Confirmation before gh pr create| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install ultralytics-dev@claude-settings |
Open /plugins -> Claude & Codex Settings -> install ultralytics-dev |
gemini extensions install --path ./plugins/ultralytics-dev |
Auto-formatting hooks for Python, JavaScript, Markdown, and Bash.
Hooks:
format_python_docstrings.py - Google-style docstring formatterpython_code_quality.py - Python code quality with ruffprettier_formatting.py - JavaScript/TypeScript/CSS/JSONmarkdown_formatting.py - Markdown formattingbash_formatting.py - Bash script formatting| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install azure-tools@claude-settings |
Open /plugins -> Claude & Codex Settings -> install azure-tools |
gemini extensions install --path ./plugins/azure-tools |
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 Azuresetup - Troubleshooting guideCommands:
/azure-tools:setup - Configure Azure MCP| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install claude-tools@claude-settings |
Open /plugins -> Claude & Codex Settings -> install claude-tools |
gemini extensions install --path ./plugins/claude-tools |
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 allowlistHooks:
sync_marketplace_to_plugins.py - Syncs marketplace.json to plugin.json| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install gcloud-tools@claude-settings |
Open /plugins -> Claude & Codex Settings -> install gcloud-tools |
gemini extensions install --path ./plugins/gcloud-tools |
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/Tracessetup - Troubleshooting guideCommands:
/gcloud-tools:setup - Configure GCloud MCP| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install paper-search-tools@claude-settings |
Open /plugins -> Claude & Codex Settings -> install paper-search-tools |
gemini extensions install --path ./plugins/paper-search-tools |
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 searchsetup - Troubleshooting guideCommands:
/paper-search-tools:setup - Configure Paper Search MCPMCP: .mcp.json | mcp/paper-search
| Claude Code | Codex CLI | Gemini CLI |
|---|---|---|
/plugin install tavily-tools@claude-settings |
Open /plugins -> Claude & Codex Settings -> install tavily-tools |
gemini extensions install --path ./plugins/tavily-tools |
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 Searchsetup - Troubleshooting guideCommands:
/tavily-tools:setup - Configure Tavily MCPHooks:
webfetch_to_tavily_extract.py - Redirect WebFetch to Tavily extractwebsearch_to_tavily_search.py - Redirect WebSearch to Tavily searchtavily_extract_to_advanced.py - Upgrade Tavily extract depthMCP: .mcp.json | tavily-ai/tavily-mcp
Configuration in .claude/settings.json:
Configuration in .claude/settings-zai.json using Z.ai GLM models via Anthropic-compatible API:
Run Claude Code with Kimi K2.5 via Anthropic-compatible API - source:
kimi-k2.5 - High-speed thinking, 256K contextexport 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:
MiniMax-M2.7 - 204K context windowMiniMax-M2.7-highspeed - high-throughput variantexport 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:
gpt-5.4 with model_reasoning_effort set to "high"responses API surfaceenv_key authenticationSettings in .vscode/settings.json:
Visual demos:
Zero-MCP goal:
New plugins/skills:
frontend-design-skills)openai-office-skills)Static website:
agentplugins.net as a plugin catalog site with search, category filtering, per-tool install snippets, and GitHub Pages hostingOther: