Teach Codex How You Actually Work With This Curated Skills List

You've probably noticed that getting Codex to do a task well is less about the prompt and more about the process—the exact steps, order, and conventions you'd follow if you were doing it yourself. Re-explaining that process every session gets old fast. Awesome Codex Skills is a curated collection of modular instruction bundles that teach Codex how to execute specific tasks the way you want them done, so you write the process down once and let the agent pick it up from there.

What It Does

At its core, this is a list of Codex skills, each living in its own folder with a SKILL.md file. That file holds metadata (a name and description) plus step-by-step guidance for a task. Codex reads the metadata to decide when a skill should fire, and only loads the full instructions after it triggers—which keeps your context window lean instead of stuffing every procedure into every conversation.

The repo organizes skills into categories: Development & Code Tools, Productivity & Collaboration, Communication & Writing, Data & Analysis, and Meta & Utilities. There's also a skill installer script that fetches a skill from GitHub and drops it into your $CODEX_HOME/skills directory, which defaults to ~/.codex/skills. The whole thing works across the Codex CLI and API.

Why It's Cool

• It's a practical pattern, not just a list. The interesting part isn't the individual skills—it's the architecture. Splitting metadata from the instruction body means Codex can have dozens of skills available without paying a context cost for all of them. That's a smart design decision that makes the system scale.

• The categories cover real work. You've got code review tools like brooks-lint (which grounds its analysis in six classic engineering books, with citations and severity labels), alongside productivity, writing, and data skills. These aren't toy examples—they map to things you'd actually want automated.

• There's a proper installer. Instead of manually copying folders around, you can point the install script at a repo and path and it handles the rest. Restart Codex, and the skill is live.

• Skills trigger themselves. Once installed, you don't have to invoke anything by name—you just describe your task, and Codex matches it against the skill descriptions. If you want, you can mention the skill name explicitly, but the matching happens automatically either way.

• The list is open to contributions. The PRs-welcome badge is right at the top, so if you've built a skill that solves a workflow problem, there's an obvious place to share it.

How to Try It

The recommended path is the skill installer. Clone the repo, then run the script with the skill you want:

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 the new skills.

If you'd rather do it by hand:

1. Copy the skill folder you want (for example, ./spreadsheet-formula-helper) into $CODEX_HOME/skills/ (defaults to ~/.codex/skills/).
2. Restart Codex so it loads the new metadata.
3. In your next session, describe the task or mention the skill name—Codex will trigger matching skills based on their description frontmatter.

Browse the full list at github.com/composio-community/awesome-codex-skills to find skills that fit your workflows.

Final Thoughts

This is a solid resource if you're already using Codex regularly and want to stop re-explaining the same processes. The skill format itself is simple enough that you'll likely end up writing your own once you see how the existing ones are structured—and the contributing section is there when you do. It's early days for a curated list like this, so the value will grow as more people add skills, but the pattern it's built on is sound and worth adopting now.