# awesome-codex-skills | Composio | Knowledge Base | Instagit

A curated list of practical Codex skills for automating workflows across the Codex CLI and API.

GitHub Stars: 1.9k

Repository: https://github.com/composiohq/awesome-codex-skills

---

## Articles

### [How to Troubleshoot MCP Server Connection Issues: Complete Diagnostic Guide](/composiohq/awesome-codex-skills/how-to-troubleshoot-mcp-server-connection-issues)

Troubleshoot MCP server connection issues with this diagnostic guide. Learn to fix transport misconfigurations, environment variables, network restrictions, and timeout handling.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Add MCP Servers to Codex: Step-by-Step Configuration Guide](/composiohq/awesome-codex-skills/how-to-add-mcp-servers-to-codex)

Easily add MCP servers to Codex with this step-by-step guide. Learn to configure your connection using the codex mcp add CLI and rmcp_client feature for seamless integration.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Handle Tool Name Conflicts Between MCP Servers: 3 Proven Strategies](/composiohq/awesome-codex-skills/how-to-handle-tool-name-conflicts-between-mcp-servers)

Resolve tool name conflicts between MCP servers with 3 proven strategies. Learn to prefix tools effectively for clear LLM integration.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Choose Between stdio, HTTP, and SSE Transport for MCP Clients](/composiohq/awesome-codex-skills/how-to-choose-between-stdio-http-and-sse-transport)

Learn when to use stdio, HTTP, and SSE transport for MCP clients. Optimize your development by choosing the right transport for local, streaming, or full-duplex connections.

- Tags: deep-dive
- Published: 2026-04-26

### [How to Implement Character Limits and Truncation in MCP Servers: A Production-Ready Pattern](/composiohq/awesome-codex-skills/how-to-implement-character-limits-and-truncation)

Implement character limits and truncation in your MCP servers effectively. Learn a production-ready pattern to manage long responses and improve performance.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Implement Pagination in MCP Servers: Python and TypeScript Examples](/composiohq/awesome-codex-skills/how-to-implement-pagination-in-mcp-servers)

Learn to implement pagination in MCP servers using Python and TypeScript. Explore techniques for handling large datasets with limit offset parameters and metadata for LLM navigation.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Handle Authentication Errors in MCP Servers: A Complete Guide](/composiohq/awesome-codex-skills/how-to-handle-authentication-errors-in-mcp)

Master MCP authentication errors. Secure your server by validating API keys at startup, catching 401 responses, and returning clear error messages. Learn expert techniques for robust authentication handling.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Create Notion Research Documentation Using Codex Skills: A 4-Step Workflow](/composiohq/awesome-codex-skills/how-to-create-notion-research-documentation)

Learn how to create Notion research documentation in 4 steps. Automate source gathering, selection, synthesis with citations, and publishing using Codex skills.

- Tags: tutorial
- Published: 2026-04-26

### [How to Manage Linear Issues Through Codex: A Step-by-Step Guide](/composiohq/awesome-codex-skills/how-to-manage-linear-issues-through-codex)

Learn how to manage Linear issues using Codex. This guide shows you how to create, update, and triage issues with natural language commands via the Linear skill.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Debug Failing GitHub Actions in Codex: Complete Guide to Automated CI Debugging](/composiohq/awesome-codex-skills/how-to-debug-failing-github-actions-in-codex)

Debug failing GitHub Actions in Codex with gh-fix-ci. Automatically identify issues, summarize logs, and get an actionable fix plan for faster CI debugging. Approve changes before they're made.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Use skill-installer with Private Repositories in Composio Codex](/composiohq/awesome-codex-skills/how-to-use-skill-installer-with-private-repos)

Easily install skills from private GitHub repos with Composio Codex skill-installer. Learn how automated token detection and SSH fallbacks ensure seamless installation.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Use Tool Annotations (readOnlyHint & destructiveHint) in Codex Skills](/composiohq/awesome-codex-skills/how-to-use-tool-annotations-readonlyhint-destructivehint)

Learn to use tool annotations like readOnlyHint and destructiveHint in Codex Skills. Enhance client application tool management with these metadata hints from ComposioHQ.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Configure MCP Servers on Windows and WSL](/composiohq/awesome-codex-skills/how-to-configure-mcp-servers-on-windows-wsl)

Configure MCP servers on Windows and WSL to prevent stdin/stdout issues and achieve POSIX compatibility. Learn the steps to set up your MCP server efficiently.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Use Zod Schemas in MCP TypeScript Servers: Complete Implementation Guide](/composiohq/awesome-codex-skills/how-to-use-zod-schemas-in-mcp-typescript-servers)

Learn to use Zod schemas in MCP TypeScript servers. Implement runtime validation and TypeScript type inference for tool inputs with server.registerTool().

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Use Pydantic Models in MCP Python Servers: A Complete FastMCP Guide](/composiohq/awesome-codex-skills/how-to-use-pydantic-models-in-mcp-python-servers)

Learn how to use Pydantic models in MCP Python servers with FastMCP. Automatically derive tool schemas and validate arguments, eliminating manual sanitization.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Design Tools for AI Agents: Workflows vs. API Endpoints](/composiohq/awesome-codex-skills/how-to-design-tools-for-ai-agents-workflow-vs-api-endpoints)

Design AI agent tools around user workflows not API endpoints for less context, lower latency, and better error recovery. Learn how Composio simplifies agent tool creation.

- Tags: best-practices
- Published: 2026-04-26

### [How to Handle Rate Limiting in MCP Implementations: A Complete Guide](/composiohq/awesome-codex-skills/how-to-handle-rate-limiting-in-mcp-implementations)

Learn how to handle rate limiting in MCP implementations with this guide. Discover token-bucket strategies, Redis, and decorators for effective quota management and error handling.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Create Evaluations for MCP Servers: A Complete Testing Guide](/composiohq/awesome-codex-skills/how-to-create-evaluations-for-mcp-servers)

Learn how to create evaluations for MCP servers. Define XML schemas, run the evaluation harness, and refine tool signatures for better API testing.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Test MCP Servers Without Hanging the Process: A Complete Guide](/composiohq/awesome-codex-skills/how-to-test-mcp-servers-without-hanging-the-process)

Learn how to test MCP servers without hanging processes. Use scripts and asyncio to ensure clean termination of hung processes and slow tool calls.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Build MCP Servers in Python vs TypeScript: A Complete Implementation Guide](/composiohq/awesome-codex-skills/how-to-build-mcp-servers-in-python-vs-typescript)

Compare Python and TypeScript for building MCP servers. Learn complete implementation guides and see how Pydantic and Zod ensure identical protocol contracts.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Handle MCP Connection Errors in Codex: Transport and Tool Error Management](/composiohq/awesome-codex-skills/how-to-handle-mcp-connection-errors-in-codex)

Handle MCP connection errors in Codex by logging to stderr and returning structured tool-error objects. Learn robust error management for LLM recovery.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Authenticate MCP Servers with OAuth in Codex: A Complete Implementation Guide](/composiohq/awesome-codex-skills/how-to-authenticate-mcp-servers-with-oauth-in-codex)

Authenticate MCP servers with OAuth in Codex using this complete implementation guide Learn how to handle authorization code exchange token storage and refresh logic for secure server authentication

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Create MCP Servers for Custom APIs: A Production-Ready Guide](/composiohq/awesome-codex-skills/how-to-create-mcp-servers-for-custom-apis)

Learn to create MCP servers for custom APIs by wrapping endpoints with FastMCP, validating with Pydantic, and exposing via STDIO, HTTP, or SSE for secure LLM agent invocation.

- Tags: how-to-guide
- Published: 2026-04-26

### [How to Install Codex Skills from Private GitHub Repositories](/composiohq/awesome-codex-skills/how-to-install-codex-skills-from-private-github-repositories)

Install Codex skills from private GitHub repos securely. Use the Skill Installer utility with a GITHUB_TOKEN for seamless authentication via ZIP or sparse-checkout. Export your token now.

- Tags: how-to-guide
- Published: 2026-04-26