Awesome Codex Skills
A curated list of practical Codex skills for automating workflows across the Codex CLI and API.
Give your skills real-world actions
Skills tell your agent how to work. An MCP Gateway gives it secure access to the tools it needs.
Composio MCP Gateway provides a single MCP endpoint for 1,000+ integrations with built-in authentication, team-based access controls, audit logs, and production-ready reliability.
Quickstart: Add Skills to Codex
Install with the Skill Installer (recommended)
git clone https://github.com/ComposioHQ/awesome-codex-skills.git
cd awesome-codex-skills
# Install one or more skills into $CODEX_HOME/skills (defaults to ~/.codex/skills)
python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions
The installer fetches the skill and places it in $CODEX_HOME/skills/<skill-name>. Restart Codex to pick up new skills.
Manual install
- Copy the desired skill folder (e.g.,
./spreadsheet-formula-helper) into $CODEX_HOME/skills/ (defaults to ~/.codex/skills/).
- Restart Codex so it loads the new metadata.
- In your next session, describe the task or mention the skill name; Codex will trigger matching skills based on their
description frontmatter.
Contents
What Are Codex Skills?
Codex skills are modular instruction bundles that tell Codex how to execute a task the way you want it done. Each skill lives in its own folder with a SKILL.md that includes metadata (name + description) and step-by-step guidance. Codex reads the metadata to decide when to trigger a skill and loads the body only after it fires, keeping context lean.
Skills
- brooks-lint - AI code reviews grounded in six classic engineering books — decay risk diagnostics with book citations, severity labels, and four analysis modes (PR review, architecture audit, tech debt, test quality). Install:
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo hyhmrright/brooks-lint --path skills/brooks-lint --name brooks-lint
- bringyour-migration-auditor - Audit Claude Code to Codex harness migrations for AGENTS.md/CLAUDE.md scope, hooks, MCP config, skills, secrets, and validation notes. Install:
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo unitedideas/bringyour-mcp --path skills/bringyour-migration-auditor --name bringyour-migration-auditor
- codebase-migrate/ - Run large codebase migrations and multi-file refactors in reviewable batches with CI verification.
- codebase-recon - Analyze git history to understand a codebase before reading any code — surfaces hotspots, bug magnets, bus factor, momentum, and high-risk files (hotspot ∩ bug-magnet) via auto-scaled analysis. Install:
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo yujiachen-y/codebase-recon-skill --path skills/codebase-recon --name codebase-recon
- create-plan/ - Quickly draft concise execution plans for coding tasks.
- deploy-pipeline/ - End-to-end Stripe → Supabase → Vercel release pipelines with verify and rollback.
- Emdash Skills - 14-category autonomous product-building OS: CF Workers + Hono + Angular + D1 + Stripe. One-line prompts to deployed SaaS with 94 reference docs, 18 agents, and Codex-native
.agents/skills/ support.
- gh-address-comments/ - Address review or issue comments on the open GitHub PR for the current branch using
gh.
- gh-fix-ci/ - Inspect failing GitHub Actions checks, summarize failures, and propose fixes.
- mcp-builder/ - Build and evaluate MCP servers with best practices and an evaluation harness.
- pr-review-ci-fix/ - Automated GitHub/GitLab PR review plus CI auto-fix loop via the Composio CLI.
- sentry-triage/ - Diagnose Sentry issues by mapping stack frames to local source — no copy-paste.
- webapp-testing/ - Run targeted web app tests and summarize results.
- AuraKit - All-in-one skill framework: 46 modes, 23 sub-agents, 6-layer OWASP security, 10 lifecycle hooks, ~55% token savings. Install:
npx @smorky85/aurakit
- Vibe-Skills - Governed Codex skill harness for staged, test-driven work: routes 340+ skills through requirement freeze, plan approval, execution, verification evidence, and cross-session memory.
- polywave - Parallel agent coordination with structural merge safety. Scout decomposes, Wave agents implement in isolated worktrees with disjoint file ownership. Same protocol on Claude Code and Codex.
Productivity & Collaboration
- connect/ - Connect Codex to 1000+ apps via the Composio CLI for real actions (Slack, GitHub, Notion, etc.).
- connect-apps/ - Wire up Composio CLI connections for Claude and kick off app workflows from the shell.
- issue-triage/ - Triage Linear or Jira backlogs and run bug sweeps from the terminal.
- linear/ - Manage issues, projects, and team workflows in Linear.
- meeting-insights-analyzer/ - Analyze meeting transcripts for themes, risks, and follow-ups.
- meeting-notes-and-actions/ - Turn meeting transcripts into summaries with decisions and owner-tagged action items.
- internal-comms/ - Craft internal announcements, updates, and stakeholder messaging.
- invoice-organizer/ - Normalize and extract invoice data for tracking and reporting.
- notion-knowledge-capture/ - Convert chats or notes into structured Notion pages with proper linking.
- notion-meeting-intelligence/ - Prepare meeting materials with Notion context plus Codex research.
- notion-research-documentation/ - Synthesize multiple Notion sources into briefs, comparisons, or reports with citations.
- notion-spec-to-implementation/ - Turn Notion specs into implementation plans, tasks, and progress tracking.
- support-ticket-triage/ - Triage customer support tickets with categories, priority, next actions, and draft replies.
- file-organizer/ - Organize, rename, and tidy files to keep workspaces clean.
- paperjsx/ - Generate PPTX presentations, DOCX documents, XLSX spreadsheets, and PDF invoices/reports/charts from structured JSON. Runs locally via
@paperjsx/mcp-server — no API key, no network calls.
- skill-share/ - Share skills and reusable instructions across teammates.
- Taisly Agent Kit - Publish approved short-form videos from Codex with a bundled skill, CLI, and remote MCP server for TikTok, Instagram Reels, YouTube Shorts, X, and Facebook.
Communication & Writing
codex-sms-verification - External repo: real-SIM SMS verification for AI agents via VirtualSMS MCP. 145+ countries, 2000+ services, both hosted (mcp.virtualsms.io) and local stdio transports.
email-draft-polish/ - Draft, rewrite, or condense emails for the right tone and audience.
changelog-generator/ - Create clear changelogs from commits or summaries.
content-research-writer/ - Research and draft content with sourced citations.
diasporic-intelligence - External repo: source-credit skill for consent-governed lineage AI with attribution, provenance, revocation, and non-impersonation boundaries.
novel-writing - External repo: public Codex skill for fiction planning, chapter drafting, scene continuation, and revision.
tailored-resume-generator/ - Tailor resumes to job descriptions with quantified impact.
unslop - External repo: CLI and MCP server that removes AI writing patterns from text: tricolons, em-dash overuse, hedging stacks, and sycophancy openers. Works with Codex, Claude Code, Gemini CLI, and Cursor. Five intensity levels and a lint-only audit mode.
Data & Analysis
- brand-guidelines/ - Apply OpenAI/Codex brand colors and typography to artifacts.
- agent-deep-links/ - Build and validate deep links for Codex, Cursor, and VS Code with Slack-safe formatting and fallback guidance.
- canvas-design/ - Generate structured canvas layouts and design artifacts.
- image-enhancer/ - Upscale and refine images with configurable presets.
- slack-gif-creator/ - Generate GIFs for Slack with captions and styling.
- theme-factory/ - Create reusable theme tokens and palettes.
- video-downloader/ - Download and prepare videos for offline review.
- template-skill/ - Starter template for building new skills.
- skill-installer/ - Helper scripts to install skills from curated lists or GitHub paths.
- skill-creator/ - Guidance for building effective Codex skills with progressive disclosure.
Using Skills in Codex
- Skills live in
$CODEX_HOME/skills (default ~/.codex/skills). Each subfolder needs a SKILL.md with name and description frontmatter.
- After installing or updating a skill, restart Codex so it reloads metadata.
- In a session, describe the task naturally; Codex auto-triggers skills whose descriptions match the request. You can also mention a skill by name if you want it considered.
- To verify installation, list installed skills (
ls ~/.codex/skills) and inspect metadata (head ~/.codex/skills/<skill>/SKILL.md).
Creating Skills
Skill layout:
skill-name/
├── SKILL.md # Required: instructions + YAML frontmatter
├── scripts/ # Optional: helper scripts for deterministic steps
├── references/ # Optional: long-form docs loaded only when needed
└── assets/ # Optional: templates or files used in outputs
Basic SKILL.md template:
---
name: my-skill-name
description: What the skill does and when Codex should use it.
---
# My Skill Name
Clear instructions and steps for Codex to execute the task.
Best practices:
- Keep the
description exhaustive about when to trigger; keep the body focused on execution steps.
- Use progressive disclosure: put detailed references in
references/ and call them out from SKILL.md only when needed.
- Include scripts for repeatable or deterministic operations; mention when Codex should run them.
- Avoid extra docs (README, changelog) inside the skill folder to keep context lean.
Contributing
PRs welcome. Add real, reusable skills, keep descriptions precise, and include any needed scripts or references. If you add new skills, ensure the description clearly states when Codex should trigger and test that metadata fits within context limits.
Resources
Join thousands of developers building agents that ship
A curated list of practical Codex skills: modular instruction bundles that teach the Codex CLI and API how to automate real workflows, from PR reviews to meeting notes.