openobserve-skills

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.

<strong>Claude Code</strong>

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

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

<strong>Codex CLI</strong>

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.

<strong>Gemini CLI</strong>

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

<strong>Cursor</strong>

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

<strong>fable-advisor</strong> - On-demand second opinion from Claude Fable 5 to pressure-test a plan, interpretation, or risky change before you commit to it

Claude Code	Codex CLI	Gemini CLI
/plugin install fable-advisor@claude-settings	Open /plugins -> Claude & Codex Settings -> install fable-advisor	gemini extensions install --path ./plugins/fable-advisor

Spawn a stronger Fable 5 reviewer to pressure-test a plan or conclusion before you commit, a drop-in for the built-in advisor when the Opus-main plus Fable-advisor pairing fails with a bare "unavailable" (#73365). It checks your load-bearing claims against the actual files and returns a skeptical review, not a rewrite.

Agents:

• fable-advisor - Fable 5 second-opinion reviewer, pass it the task, your approach, and the evidence

<strong>intelligent-compact</strong> - 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

<strong>claude-telemetry-hooks</strong> - 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-project chat_id
• user_prompt_reject_feedback.py - UserPromptSubmit hook that categorizes tool-rejection reasons

<strong>anthropic-office-skills</strong> - 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.

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

<strong>openai-office-skills</strong> - 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

<strong>python-skills</strong> - 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 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

<strong>react-skills</strong> - 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

<strong>agent-browser</strong> - 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

<strong>frontend-design-skills</strong> - 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

<strong>mongodb-skills</strong> - 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

<strong>supabase-skills</strong> - 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

<strong>stripe-skills</strong> - 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

<strong>polar-skills</strong> - 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

<strong>livekit-skills</strong> - 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

<strong>cloudflare-skills</strong> - 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

<strong>web-performance-skills</strong> - 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

<strong>openobserve-skills</strong> - 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 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

<strong>hetzner-skills</strong> - 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

<strong>dokploy-skills</strong> - 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

<strong>anthropic-essentials</strong> - 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 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

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

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

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

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

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

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

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

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

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

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 Azure
• setup - Troubleshooting guide

Commands:

• /azure-tools:setup - Configure Azure MCP

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

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

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 allowlist

Hooks:

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

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

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/Traces
• setup - Troubleshooting guide

Commands:

• /gcloud-tools:setup - Configure GCloud MCP

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

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

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 search
• setup - Troubleshooting guide

Commands:

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

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

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

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

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

Claude Code	Codex CLI	Gemini CLI
/plugin install overleaf-skills@claude-settings	Open /plugins -> Claude & Codex Settings -> install overleaf-skills	gemini extensions install --path ./plugins/overleaf-skills

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

<strong>Claude Code</strong>

Configuration in .claude/settings.json:

• Model: OpusPlan mode (plan: Opus 4.8, execute: Opus 4.8, fast: Sonnet 4.6) - source
• Environment: bash working directory, telemetry disabled, MCP output limits
• Permissions: bash commands, git operations, MCP tools
• Auto mode: auto permission mode with a custom autoMode classifier block in .claude/settings.json - see the auto mode config reference for what each rule section does, and run claude auto-mode defaults to print the current built-in block and allow rules
• Advisor: a stronger model reviews key decisions via the advisor tool, paired as Opus main plus Opus advisor. Fable 5 as advisor currently fails with a bare "unavailable" (#73365), so for an on-demand Fable second opinion use the standalone fable-advisor plugin
• Plugins: All plugins enabled

<strong>Z.ai (85% cheaper)</strong>

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

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

<strong>Kimi K2.5</strong>

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

<strong>MiniMax M3 (1M context)</strong>

Run Claude Code with MiniMax M3 via Anthropic-compatible API - source:

• Model: MiniMax-M3[1m] - 1M context window (512K guaranteed minimum, [1m] unlocks the full 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-M3[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M3[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M3[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7-highspeed
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000
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.

<strong>OpenAI Codex</strong>

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

<strong>VSCode</strong>

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
• Thinking display: point claudeCode.claudeProcessWrapper at a small wrapper that forces --thinking-display summarized, so thinking tokens still show in the extension (works around 2.1.111+ dropping the flag)

<code>~/.local/bin/claude-wrapper</code> (chmod +x)

#!/bin/bash
# Workaround for VS Code Claude Code extension 2.1.111+ not passing
# --thinking-display to the binary on Opus 4.7 (API default changed
# to "omitted", so thinking blocks arrive empty).
exec "$@" --thinking-display summarized

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!

Contributors