skills.rest
tankygranny05
tankygranny05COMMUNITY
Explore all skills by this author →
GitHub

claude-codex-skill-porter

Converts AI skills between Claude Code and Codex CLI formats.

2|Updated Jan 30, 2026
Search Tags:#compatibility#codex#claude#cli tools#porting#skill conversion
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill claude-codex-skill-porter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-codex-skill-porter
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/codex-skills/claude-codex-skill-porter
Command: npx skills add https://github.com/tankygranny05/agent-box --skill claude-codex-skill-porter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill bridges the gap between Claude Code and Codex CLI skill formats, ensuring smooth transitions and compatibility when moving skills between environments or troubleshooting loading issues.

Core Features & Use Cases

  • Cross-Platform Conversion: Effortlessly convert skills between Claude's ~/.claude/skills and Codex's ~/.codex/skills (and vice versa).
  • Format Validation: Identifies and helps resolve common gotchas like name/description length limits, symlinks, and hidden directories that can prevent skills from loading.
  • Use Case: You've developed a useful skill in Claude Code and need to use it with Codex. This Skill guides you through the exact steps and checks required to ensure it works correctly in the new environment.

Quick Start

Use the claude-codex-skill-porter to convert the skill located at ~/.claude/skills/my-new-skill to the Codex format and place it in ~/.codex/skills/.

Frequently Asked Questions about claude-codex-skill-porter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I port skills between Claude Code and Codex CLI formats?▼

To port skills between Claude Code and Codex CLI, convert the skill directory structures from `~/.claude/skills` to `~/.codex/skills` while adjusting file naming conventions and metadata field length limits to ensure successful cross-platform loading.

Why does my Claude skill fail to load after moving it to Codex CLI?▼

Skills fail to load in Codex CLI due to compatibility issues like exceeding field length limits, using symlinks, or having hidden directory prefixes. Rectifying these metadata constraints and structural differences resolves the loading errors.

What format validation issues prevent skills from being discovered across Claude and Codex?▼

Common format validation issues preventing skill discovery include exceeding name and description length limits, utilizing symlinks instead of direct files, and using hidden directory prefixes that break the expected directory structure conventions.

Can I use the same skill directory structure for both Claude Code and Codex?▼

You cannot use the identical directory structure directly because Claude and Codex use different paths, file naming conventions, and metadata constraints. You must convert the skill format to match the target platform's specific requirements.

What's the best way to convert a Claude Code skill to work with Codex CLI?▼

The best way to convert a Claude Code skill to Codex CLI is to identify and rectify common gotchas like name and description length limits, symlink usage, and hidden directory prefixes before placing the converted skill in `~/.codex/skills/`.

Related Skills

Explore More Software Engineering Skills→
galatanovidiugalatanovidiu
2

install-hyper

Symlink Hyper skill folders into Codex, PI, and agent skill directories.

Community
Intermediate
coco-researchcoco-research
264

using-superpowers

Enforce mandatory skill discovery and activation before responding across Claude Code, Gemini CLI, and Codex.

Community
Advanced
goldengrapegoldengrape
18

test-skill-encoding

{blanked}

Community
Basic
EmrebenerEmrebener

uninstalling-sublime-skills

Remove Sublime-Skills symlinks from Claude Code and Codex directories.

Community
Basic