Guides / Codex

Codex skills: find one, install it, verify the result.

A source-linked directory and file template for repeatable coding tasks. Start with your workflow, then check its prerequisites before installing.

Sources checked September 12, 2026 · Not runtime certification.

What a skill adds

A skill supplies task-specific instructions and supporting files. Codex can select it from its description, or you can mention it explicitly. Keep repository-wide instructions in AGENTS.md and use a skill for a repeatable task.

OpenAI skills documentation

Choose a skill by the job

These entries link directly to OpenAI’s catalog. Read the current instructions and scripts; inclusion here is not a guarantee of successful execution.

Work through PR feedback

gh-address-comments

Finds comments on the current branch’s GitHub PR, summarizes them, and asks which to address before making the selected fixes.

Before use: GitHub CLI authentication and repository access.

Read the source →

Investigate failing CI

gh-fix-ci

Inspects GitHub Actions checks and logs, explains the failure, then proposes a fix for approval. Other CI providers are outside its scope.

Before use: GitHub CLI authentication and readable Actions logs.

Read the source →

Inspect a browser workflow

playwright

Uses Playwright CLI to navigate, fill forms, capture screenshots and debug UI flows. It does not promise a complete test suite.

Before use: Node.js/npm with npx; browser and wrapper setup described in the source.

Read the source →

Install inside Codex, then check discovery

Use the bundled installer in an interactive Codex prompt. This is not a shell command:

$skill-installer gh-address-comments

Open /skills inside Codex CLI, then try $gh-address-comments on a repository you can access. If missing, restart Codex. The installer defaults to ~/.codex/skills via CODEX_HOME; that differs from the documented personal folder for manually authored skills.

Installer source and destination options

Create a small SKILL.md

Create .agents/skills/review-export-change/SKILL.md in your repository, or ~/.agents/skills/review-export-change/SKILL.md for personal use. On Windows, ~ means your user home directory.

This original review-only template includes the required YAML name and description. Its body defines the task and output boundary.

SKILL.md
---
name: review-export-change
description: Review a CSV export change for selected-row behavior and access-control regressions. Use when asked to review an export diff; do not use for unrelated changes.
---

1. Read the requested diff and the existing export behavior.
2. Check selected rows, empty selection, and permission boundaries.
3. Report concrete findings with file references and expected behavior.
4. State which checks were run and which remain unverified.
Do not edit files or claim a check passed without evidence.

Try a disposable example diff containing an empty-selection defect. The review should identify the defect and say what was checked. Try an unrelated request to see whether the description is too broad.

Agent Skills format specification

Codex skills vs Claude Code skills

DetailCodex CLIClaude Code
Project folder.agents/skills/.claude/skills/
Manual personal folder~/.agents/skills/~/.claude/skills/
Explicit invocation$skill-name/skill-name
Automatic selectionMatches the descriptionMatches the description

Both use SKILL.md with YAML metadata. Shared instructions may transfer, but paths, tools and host-specific settings need checking. This is a format comparison, not a model-quality ranking.

Claude Code skills documentation

Installation and discovery questions

What are Codex skills?

Reusable instructions in SKILL.md, with optional scripts and references. They describe a workflow; they do not grant accounts, permissions or tools by themselves.

Where do I put a custom Codex skill?

Use .agents/skills/<name>/SKILL.md in a repository or ~/.agents/skills/<name>/SKILL.md for a personal skill. The bundled installer has its own destination; inspect its output.

Why is my skill not showing up?

Check the filename, YAML name and description, and repository location. Open /skills inside Codex CLI. If it remains absent, restart Codex and check again.

Does installation prove a skill works?

No. Discovery only confirms Codex can find it. Try one bounded task and inspect the actual output, permissions and verification evidence.

AE
AgentSkillsHub Editorial TeamAI Agent Infrastructure Reviewers

The AgentSkillsHub editorial team evaluates MCP servers, Claude skills, and AI agent integrations for security, reliability, and practical deployment readiness. Every listing undergoes permission audit, README analysis, and operational risk triage before publication.

  • Reviewed 450+ MCP server repositories
  • Developed security grading methodology (A-F)
  • Published agent deployment safety guidelines
Updated: 2026-09-12github