hooks-92dede— hook

<div align="center"> <img src="https://github.com/user-attachments/assets/a978cb0a-785d-4a7d-aff2-7e962edd3120" width="10000" alt="Claude Codex Settings Logo">

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

</div>

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.

<details open> <summary><strong>Claude Code</strong></summary>

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

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

</details>

<details> <summary><strong>Codex CLI</strong></summary>

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.

</details>

<details> <summary><strong>Gemini CLI</strong></summary>

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

</details>

<details> <summary><strong>Cursor</strong></summary>

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

</details>

Create symlinks for cross-tool compatibility:

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

Plugins

<details> <summary><strong>intelligent-compact</strong> - Stop Claude Code from forgetting file paths, root causes, and open questions when it auto-summarizes long sessions</summary>

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

</details>

<details> <summary><strong>claude-telemetry-hooks</strong> - Track per-device Claude Code usage, rejection reasons, and per-session stats from a single dashboard</summary>

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

</details>

<details> <summary><strong>anthropic-office-skills</strong> - Official Anthropic PDF, Word, PowerPoint, Excel skills</summary>

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

</details>

<details> <summary><strong>openai-office-skills</strong> - Official OpenAI PDF, Word, PowerPoint, Excel skills</summary>

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

</details>

<details> <summary><strong>python-skills</strong> - Python best practices from PEP 8, Zen of Python, Google Style Guide, Effective Python</summary>

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

</details>

<details> <summary><strong>react-skills</strong> - Official React, Next.js, and React Native best practices</summary>

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

</details>

<details> <summary><strong>agent-browser</strong> - Official browser automation CLI for AI agents</summary>

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

</details>

<details> <summary><strong>frontend-design-skills</strong> - Official frontend design skills (Anthropic + OpenAI)</summary>

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

</details>

<details> <summary><strong>mongodb-skills</strong> - Official MongoDB agent skills for schema design, query tuning, and Atlas Search</summary>

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

</details>

<details> <summary><strong>supabase-skills</strong> - Supabase Postgres best practices, JavaScript SDK, and CLI skills</summary>

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

</details>

<details> <summary><strong>stripe-skills</strong> - Official Stripe agent skills for payments, billing, Connect, and API upgrades</summary>

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

</details>

<details> <summary><strong>polar-skills</strong> - Official Polar agent skills for billing, subscriptions, and local dev environment</summary>

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

</details>

<details> <summary><strong>livekit-skills</strong> - LiveKit voice AI agent development (Cloud + self-hosted)</summary>

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

</details>

<details> <summary><strong>cloudflare-skills</strong> - Official Cloudflare developer platform skill for Workers, R2, D1, KV, AI, and 50+ services</summary>

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

</details>

<details> <summary><strong>web-performance-skills</strong> - Web performance auditing with Core Web Vitals, Lighthouse, and Chrome DevTools</summary>

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

</details>

<details> <summary><strong>openobserve-skills</strong> - OpenObserve REST API skill for AI agents to search logs/metrics/traces and create dashboards via curl</summary>

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

</details>

<details> <summary><strong>hetzner-skills</strong> - Hetzner Cloud CLI skill for servers, networks, firewalls, load balancers, DNS, and storage</summary>

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

</details>

<details> <summary><strong>dokploy-skills</strong> - Dokploy deployment skill for Dokploy Cloud and self-hosted dashboards</summary>

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

</details>

<details> <summary><strong>anthropic-essentials</strong> - Feature dev, CLAUDE.md management, skill creation</summary>

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

</details>

<details> <summary><strong>anthropic-plugin-dev</strong> - Plugin development toolkit</summary>

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

</details>

<details> <summary><strong>phd-skills</strong> - Hypothesis design, paper review, citation checks</summary>

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

</details>

<details> <summary><strong>github-dev</strong> - Git workflow agents + skills</summary>

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

</details>

<details> <summary><strong>ultralytics-dev</strong> - Auto-formatting hooks</summary>

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

</details>

<details> <summary><strong>azure-tools</strong> - Azure MCP & Skills</summary>

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

</details>

<details> <summary><strong>claude-tools</strong> - Sync CLAUDE.md + allowlist + context refresh</summary>

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

</details>

<details> <summary><strong>gcloud-tools</strong> - GCloud MCP & Skills</summary>

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

</details>

<details> <summary><strong>paper-search-tools</strong> - Paper Search MCP & Skills</summary>

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

</details>

<details> <summary><strong>tavily-tools</strong> - Tavily MCP & Skills</summary>

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

</details>

<details> <summary><strong>overleaf-skills</strong> - Pull Overleaf review comments into your local .tex repo and apply the suggested edits</summary>

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

</details>

Configuration

<details> <summary><strong>Claude Code</strong></summary>

Configuration in .claude/settings.json:

• Model: OpusPlan mode (plan: Opus 4.8, execute: Opus 4.8, fast: Sonnet 4.6) - [source](https://github.com/anthropics/claude-code/blob/4dc23d0275ff615ba1dccbdd76a