--- title: "Codex skills: run curated Agent Skills in Codex CLI · skilld" description: "Find curated Codex Skills with readable sources. Learn where Skills load, how to run or install them, and how to check your own Skill across Agents." canonical_url: "https://skilld.dev/agents/codex" last_updated: "2026-09-06T07:10:36.521Z" meta: "og:description": "Find curated Codex Skills with readable sources. Learn where Skills load, how to run or install them, and how to check your own Skill across Agents." "og:image": "https://skilld.dev/_og/d/a_~Q29kZXggc2tpbGxzOiBydW4gY3VyYXRlZCBBZ2VudCBTa2lsbHMgaW4gQ29kZXggQ0xJ%2Cc_Page.takumi%2Ctitle_~Q29kZXggc2tpbGxzOiBydW4gY3VyYXRlZCBBZ2VudCBTa2lsbHMgaW4gQ29kZXggQ0xJ%2Cdescription_~RmluZCBjdXJhdGVkIENvZGV4IFNraWxscyB3aXRoIHJlYWRhYmxlIHNvdXJjZXMuIExlYXJuIHdoZXJlIFNraWxscyBsb2FkLCBob3cgdG8gcnVuIG9yIGluc3RhbGwgdGhlbSwgYW5kIGhvdyB0byBjaGVjayB5b3VyIG93biBTa2lsbCBhY3Jvc3MgQWdlbnRzLg%2Cp_Ii9hZ2VudHMvY29kZXgi%2Cs_kBZaMmDgSES03MsL.png" "og:image:alt": "Codex skills: run curated Agent Skills in Codex CLI" "og:image:height": "600" "og:image:type": image/png "og:image:width": "1200" "og:title": "Codex skills: run curated Agent Skills in Codex CLI" "twitter:image": "https://skilld.dev/_og/d/a_~Q29kZXggc2tpbGxzOiBydW4gY3VyYXRlZCBBZ2VudCBTa2lsbHMgaW4gQ29kZXggQ0xJ%2Cc_Page.takumi%2Ctitle_~Q29kZXggc2tpbGxzOiBydW4gY3VyYXRlZCBBZ2VudCBTa2lsbHMgaW4gQ29kZXggQ0xJ%2Cdescription_~RmluZCBjdXJhdGVkIENvZGV4IFNraWxscyB3aXRoIHJlYWRhYmxlIHNvdXJjZXMuIExlYXJuIHdoZXJlIFNraWxscyBsb2FkLCBob3cgdG8gcnVuIG9yIGluc3RhbGwgdGhlbSwgYW5kIGhvdyB0byBjaGVjayB5b3VyIG93biBTa2lsbCBhY3Jvc3MgQWdlbnRzLg%2Cp_Ii9hZ2VudHMvY29kZXgi%2Cs_kBZaMmDgSES03MsL.png" "twitter:image:alt": "Codex skills: run curated Agent Skills in Codex CLI" --- > Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt) # **Codex skills** Find curated Codex Skills with readable sources. Learn where Skills load, how to run or install them, and how to check your own Skill across Agents. Agents `npx skilld run owner/repo/skill` Codex is OpenAI's coding Agent for the terminal and the editor. It reads Agent Skills from a directory in your project or your home directory. skilld gives you a curated set of those Skills, each written by a person in their own repository, and one command that puts a Skill in front of Codex. ## How Skills work in Codex Codex loads a Skill from a `**SKILL.md**` file. Each Skill sits in its own directory. - Project: `**.agents/skills//SKILL.md**` - Global: `**~/.agents/skills//SKILL.md**` Amp and Zed read the same two directories. One install serves all three Agents. Codex discovers Skills at startup. It keeps each name and description in context. When a task matches a description, Codex loads the full file and follows it. To write your own, follow [**Write a Skill that works across Agents**](https://skilld.dev/learn/create-agent-skills). Start with a complete `**SKILL.md**`, then check discovery and task completion in Codex. ### Install a Skill for Codex ```sh npx skilld install owner/repo/skill --agent codex ``` The Skill lands in `**.agents/skills**`. Add `**--global**` to install to `**~/.agents/skills**` instead. skilld detects the Agents in your project and on your machine. If it finds only one, omit `**--agent**`. Start a new Codex session after an install. Codex reads the directory at startup. ### Run a Skill without installing it ```sh npx skilld run owner/repo/skill ``` `**skilld run**` prints the Skill and writes no file. Give the command to Codex. It reads the Skill and follows it for this session. Nothing lands in your repository, and no lockfile changes. ## Codex CLI Skills The Codex CLI and the Codex editor extension share the `**.agents/skills**` directory in a project. A Skill you install once works in both. Several lists on [**GitHub**](https://github.com) call themselves awesome Codex skills. They collect links. The registry admits fewer Skills, names the author of each, and links the exact source file. Read the file, then decide. ## **Curated Skills for Codex** Codex CLI work lives in the terminal next to the test runner, so these Skills cover testing and debugging. Skills here come from the curated registry; a person admitted each one. - [/tdd](https://skilld.dev/gh/mattpocock/skills/tdd) mattpocock/skills Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests. 293k GitHub stars - [/test-driven-development](https://skilld.dev/gh/obra/superpowers/test-driven-development) obra/superpowers Use when implementing any feature or bugfix, before writing implementation code 299k GitHub stars - [/assessing-test-coverage](https://skilld.dev/gh/bitwarden/ai-plugins/assessing-test-coverage) bitwarden/ai-plugins Use when determining what test coverage ALREADY exists for a specific change (a PR, Jira key, Tech Breakdown doc, Testmo CSV, changed paths, or named component). Triggers on "what's already tested", "does this PR have tests", "what coverage exists for", "is this component covered", or "which behaviors have no test today". This is a backward-looking inventory of existing coverage for a concrete change. Do NOT use it to recommend or decide which new tests to add ("should I add integration tests here", "are unit tests enough"), to design a test strategy or plan, to run or fix existing tests, or to explain testing concepts like the test pyramid or which layers a repo uses — those are all out of scope. 158 GitHub stars - [/systematic-debugging](https://skilld.dev/gh/obra/superpowers/systematic-debugging) obra/superpowers Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes 299k GitHub stars - [/verifying-external-behavior](https://skilld.dev/gh/wdm0006/python-skills/verifying-external-behavior) wdm0006/python-skills Confirms what a third-party library, remote API, build backend, or scraped document actually does before writing code that depends on it — throwaway probes that run in seconds, permissive clients that forward wrong arguments instead of rejecting them, per-endpoint docs that don't generalize, response shapes that make a "fast path" always-false, fakes that encode your assumption rather than the service's behavior, dry-runs that skip the step that fails, and large inputs that were silently read only in part. Use when integrating a new dependency or endpoint, writing a tolerated-status or error branch, choosing a client argument name, testing against a fake, or reviewing code that asserts an upstream contract. 102 GitHub stars - [/webapp-testing](https://skilld.dev/gh/anthropics/skills/webapp-testing) anthropics/skills Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. 181k GitHub stars - [/autonomous-investigation](https://skilld.dev/gh/deanpeters/product-manager-skills/autonomous-investigation) deanpeters/product-manager-skills The protocol behind every investigation skill. Use when AI research must proceed without you: search-plan gate, Fact/Inference/Assumption labels, confidence stacking, diffable outputs. 7.4k GitHub stars - [/post-mortem](https://skilld.dev/gh/boshu2/agentops/post-mortem) boshu2/agentops Compatibility pointer for the canonical postmortem skill. 448 GitHub stars [All 97 Skills in Testing and debugging](https://skilld.dev/skills/testing) Codex can also search the registry itself, with the skilld Skill or the skilld MCP server. [See the setup](https://skilld.dev/developers) **Read before you run.** A Skill is instructions for your Agent. Open the source file first. [What skilld verifies, and what it never claims](https://skilld.dev/verify) . ```json {"@context":"https://schema.org","@graph":[{"@id":"https://skilld.dev/#website","@type":"WebSite","description":"Curated agent skills by humans, written by real maintainers in their own GitHub repos","name":"skilld","url":"https://skilld.dev/"},{"@id":"https://skilld.dev/agents/codex#webpage","@type":"WebPage","description":"Find curated Codex Skills with readable sources. Learn where Skills load, how to run or install them, and how to check your own Skill across Agents.","name":"Codex skills: run curated Agent Skills in Codex CLI","url":"https://skilld.dev/agents/codex","isPartOf":{"@id":"https://skilld.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://skilld.dev/agents/codex"]}]},{"@id":"https://skilld.dev/agents/codex#skills","@type":"ItemList","name":"Curated Skills for Codex","itemListElement":[{"@type":"ListItem","position":1,"url":"https://skilld.dev/gh/mattpocock/skills/tdd","name":"tdd"},{"@type":"ListItem","position":2,"url":"https://skilld.dev/gh/obra/superpowers/test-driven-development","name":"test-driven-development"},{"@type":"ListItem","position":3,"url":"https://skilld.dev/gh/bitwarden/ai-plugins/assessing-test-coverage","name":"assessing-test-coverage"},{"@type":"ListItem","position":4,"url":"https://skilld.dev/gh/obra/superpowers/systematic-debugging","name":"systematic-debugging"},{"@type":"ListItem","position":5,"url":"https://skilld.dev/gh/wdm0006/python-skills/verifying-external-behavior","name":"verifying-external-behavior"},{"@type":"ListItem","position":6,"url":"https://skilld.dev/gh/anthropics/skills/webapp-testing","name":"webapp-testing"},{"@type":"ListItem","position":7,"url":"https://skilld.dev/gh/deanpeters/product-manager-skills/autonomous-investigation","name":"autonomous-investigation"},{"@type":"ListItem","position":8,"url":"https://skilld.dev/gh/boshu2/agentops/post-mortem","name":"post-mortem"}]}]} ```