Agent skill

Codex CLI Specialist

by borghei in borghei/Claude-Skills

OpenAI Codex CLI and cross-platform skill authoring. An agent skill from borghei/Claude-Skills.

MITAuto-check passedAgent Workflows

Install Codex CLI Specialist

skills CLI
$ npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills codex-cli-specialist --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/codex-cli-specialist .claude/skills/codex-cli-specialist && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codex-cli-specialist
GitHub stars
874
Token cost
~1.8k tokens
SKILL.md length
697 words
Files
10 (incl. scripts, references, assets)
Skills in repo
364
Repo updated
First seen
Licence
MIT

At a glance

OpenAI Codex CLI and cross-platform skill authoring. An agent skill from borghei/Claude-Skills.

  • Setting up Codex CLI
  • SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 3 more sections
  • Runs Python scripts from its folder; calls python
  • Syncing skills between Claude Code and Codex

What it does

Codex CLI Specialist is an agent skill from borghei/Claude-Skills. OpenAI Codex CLI and cross-platform skill authoring. Use when setting up Codex CLI, converting or syncing skills between Claude Code and Codex, configuring agents/openai.yaml, or validating cross-platform skill compatibility.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts, reference files and assets (for example `assets/openai-yaml-template.yaml`, `references/best-practices-and-troubleshooting.md` and `references/codex-cli-guide.md`).

It sits in Agent Workflows, covering Skill authoring. It works with OpenAI. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Setting up Codex CLI
  • Syncing skills between Claude Code and Codex
  • Configuring agents/openai.yaml
  • Validating cross-platform skill compatibility

Example prompts

  • “/codex-cli-specialist”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit c9a1487. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex CLI Specialist loads about 1.8k tokens when it runs, and up to ~15k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 697 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~15k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 697 words, ~1,814 tokens.

Download SKILL.mdSave it as .claude/skills/codex-cli-specialist/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
codex-cli-specialist
description
OpenAI Codex CLI and cross-platform skill authoring. Use when setting up Codex CLI, converting or syncing skills between Claude Code and Codex, configuring agents/openai.yaml, or validating cross-platform skill compatibility.
license
MIT + Commons Clause
metadata.version
1.1.0
metadata.author
borghei
metadata.category
engineering
metadata.domain
development-tools
metadata.updated
2026-06-17
metadata.tags
openai-codex, cross-platform, skill-conversion, cli

Codex CLI Specialist

The agent converts Claude Code skills to Codex-compatible format, validates cross-platform compatibility, and builds skill registry manifests. It generates agents/openai.yaml configurations from SKILL.md frontmatter, runs 17 compatibility checks across both platforms, and produces skills-index.json for discovery systems.

Core Capabilities

  • Skill conversion — turn a Claude Code SKILL.md into a Codex-compatible skill by generating agents/openai.yaml and copying scripts/references/assets.
  • Cross-platform validation — run 17 checks across Claude Code, Codex CLI, and shared categories (frontmatter, openai.yaml, encoding, naming, size).
  • Index building — scan skill directories and emit a skills-index.json manifest for registries, discovery, and version pinning.
  • Codex CLI setup & operation — install, configure API access, and run with the right approval mode (suggest / auto-edit / full-auto).
  • Dual-target authoring — write skills that work on both platforms from one shared scripts/, references/, assets/ tree.
  • Distribution & sync — keep Claude Code and Codex in sync via shared repo, CI/CD conversion, or git hooks; publish via GitHub releases.

When to Use

  • Setting up or operating OpenAI Codex CLI.
  • Converting or syncing skills between Claude Code and Codex.
  • Configuring or reviewing agents/openai.yaml.
  • Validating a skill for dual-platform compatibility.
  • Building a skills-index.json for a skill library.

Clarify First

Before converting or building, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Task — convert a skill, validate cross-platform compatibility, or build a skills index (selects codex_skill_converter.py vs cross_platform_validator.py vs skills_index_builder.py)
  • Source path — the SKILL.md or skill directory to operate on (the input the scripts read)
  • Strictness — strict validation mode and whether to fail on warnings (sets --strict and the pass/fail gate)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Tools

ToolPurposeCommand
codex_skill_converter.pyConvert a Claude Code SKILL.md into Codex format (agents/openai.yaml)python scripts/codex_skill_converter.py <skill_md> [--output-dir DIR] [--json]
cross_platform_validator.pyRun 17 Claude Code + Codex + cross-platform compatibility checks on a skill dirpython scripts/cross_platform_validator.py <skill_dir> [--strict] [--json]
skills_index_builder.pyBuild a skills-index.json manifest from a directory of skillspython scripts/skills_index_builder.py <skills_dir> [--output FILE] [--format json|human] [--category CAT]

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/workflows.md — Quick Start, Tools Overview, the 5 core workflows (install, author, convert, validate, build index), Common Patterns, and deep per-tool parameter/output reference. Read when running a workflow or needing exact tool arguments.
  • references/configuration-and-distribution.md — agents/openai.yaml structure, discovery/locations, invocation patterns, cross-platform patterns, frontmatter compatibility, install/versioning, and sync/CI/CD/GitHub distribution. Read when configuring openai.yaml or distributing a library.
  • references/best-practices-and-troubleshooting.md — best practices (authoring, Codex usage, cross-platform, performance), anti-patterns, troubleshooting table, and success criteria. Read before shipping or when a tool misbehaves.
  • references/codex-cli-guide.md — full Codex CLI reference: installation, configuration, approval modes, skill system, invocation, built-in features, environment variables.
  • references/cross-platform-skills.md — writing skills for multiple agents (Claude Code, Codex, Cursor, Copilot, Goose): platform comparison, universal structure, per-platform config files, template.
  • assets/openai-yaml-template.yaml — production-grade Codex config template (instructions, tools, model selection, versioning).
Show full SKILL.md (220 more words)Show less

Scope & Limitations

This skill covers:

  • Installing, configuring, and operating OpenAI Codex CLI
  • Converting Claude Code SKILL.md files into Codex-compatible format with agents/openai.yaml
  • Validating skill directories for dual-platform (Claude Code + Codex CLI) compatibility
  • Building skill registry manifests (skills-index.json) for discovery and distribution

This skill does NOT cover:

  • Writing the actual domain logic inside Python tool scripts (see senior-fullstack, code-reviewer, or the relevant domain skill)
  • Cursor, Windsurf, Cline, or Aider platform-specific configuration (see standards/ and root-level dotfiles like .cursorrules, .windsurfrules)
  • OpenAI API key management, billing, or rate-limit troubleshooting (out of scope -- refer to OpenAI documentation)
  • Automated testing or CI/CD pipeline authoring beyond skill validation (see senior-devops and templates/)

Integration Points

SkillIntegrationData Flow
code-reviewerConvert code-reviewer's SKILL.md to Codex format so it can run in Codex CLIcodex_skill_converter.py reads code-reviewer's SKILL.md and generates agents/openai.yaml
senior-fullstackValidate fullstack skill's cross-platform compatibility after adding Codex supportcross_platform_validator.py checks both SKILL.md frontmatter and openai.yaml structure
senior-devopsEmbed skill validation and index building into CI/CD pipelinesDevOps workflows call cross_platform_validator.py --strict --json and skills_index_builder.py as pipeline steps
tech-stack-evaluatorEvaluate whether Codex CLI fits a project's AI tooling stackTech stack evaluator references Codex CLI capabilities and configuration patterns from this skill
senior-architectArchitect multi-agent skill systems that span Claude Code and Codex CLIArchitect uses cross-platform skill patterns and index manifests to plan skill distribution

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references, assets) in engineering/codex-cli-specialist of borghei/Claude-Skills.

  • SKILL.md
  • assets/openai-yaml-template.yaml
  • references/best-practices-and-troubleshooting.md
  • references/codex-cli-guide.md
  • references/configuration-and-distribution.md
  • references/cross-platform-skills.md
  • references/workflows.md
  • scripts/codex_skill_converter.py
  • scripts/cross_platform_validator.py
  • scripts/skills_index_builder.py

Open the folder on GitHubat commit c9a1487

Compare with similar skills

Codex CLI Specialist next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex CLI Specialist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex CLI Specialist this skillborghei/Claude-Skills874—~1.8kAutomated safety check: PassMIT
Daily Logsmemodb-io/Acontext3.7k—~243Automated safety check: PassApache-2.0
Skill CreatorMemTensor/memmy-agent2.1k—~944Automated safety check: PassMIT
User General Factsmemodb-io/Acontext3.7k—~439Automated safety check: PassApache-2.0
Skill Creatordkyazzentwatwa/chatgpt-skills112—~444Automated safety check: PassApache-2.0
Skill CreatorAzure/azqr79489 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • Daily Logs

    memodb-io/Acontext

    Track daily activity logs and summaries for the user. An agent skill from memodb-io/Acontext.

    3.7k GitHub stars~243 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Skill Creator

    MemTensor/memmy-agent

    Create, edit, improve, tidy, review, audit, or restructure memmy-agent skills and SKILL.md files.

    2.1k GitHub stars~944 tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • User General Facts

    memodb-io/Acontext

    Capture and organize general facts about the user by topic. An agent skill from memodb-io/Acontext.

    3.7k GitHub stars~439 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Skill Creator

    dkyazzentwatwa/chatgpt-skills

    Create or update agent skills with concise SKILL.md instructions, bundled resources, agent metadata, validation, and packaging.

    112 GitHub stars~444 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    794 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 10 repos~3.5k tokens
    Agent WorkflowsAuto-check passed

More from borghei/Claude-Skills

All 364 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    874 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    874 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    874 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    874 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Codex CLI Specialist

What does Codex CLI Specialist do?

OpenAI Codex CLI and cross-platform skill authoring. An agent skill from borghei/Claude-Skills. Codex CLI Specialist is an agent skill from borghei/Claude-Skills. OpenAI Codex CLI and cross-platform skill authoring.

When should I use Codex CLI Specialist?

Codex CLI Specialist fits situations like: setting up Codex CLI; syncing skills between Claude Code and Codex; configuring agents/openai.yaml; validating cross-platform skill compatibility.

How do I install Codex CLI Specialist in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a claude-code`. Or copy the skill folder (engineering/codex-cli-specialist in borghei/Claude-Skills) into .claude/skills/codex-cli-specialist in your project. Claude Code loads it when a task matches its description.

How do I install Codex CLI Specialist in Codex?

Run `npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a codex`. Or copy the skill folder (engineering/codex-cli-specialist in borghei/Claude-Skills) into .agents/skills/codex-cli-specialist in your project. Codex loads it when a task matches its description.

Can I use Codex CLI Specialist in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill codex-cli-specialist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-cli-specialist, .gemini/skills/codex-cli-specialist, .github/skills/codex-cli-specialist and .opencode/skills/codex-cli-specialist in your project.

What does Codex CLI Specialist need to run?

Going by SKILL.md and its folder, Codex CLI Specialist needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Codex CLI Specialist access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex CLI Specialist safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codex CLI Specialist use?

Codex CLI Specialist is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex CLI Specialist use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Codex CLI Specialist?

Skills that share tags, products or a category with Codex CLI Specialist: Daily Logs (memodb-io/Acontext, 3.7k stars), Skill Creator (MemTensor/memmy-agent, 2.1k stars), User General Facts (memodb-io/Acontext, 3.7k stars) and Skill Creator (dkyazzentwatwa/chatgpt-skills, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex CLI Specialist?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.