cant install it to codex

[TylonHH]

Hi,

I thought codex is supported, but I got this

npx ai-agent-skills install alirezarezvani/claude-skills --agent codex --dry-run

Dry Run (no changes made)
Would clone: https://github.com/alirezarezvani/claude-skills.git
Would install all skills from repo
Agent: codex

npx ai-agent-skills install alirezarezvani/claude-skills --agent codex

Cloning alirezarezvani/claude-skills...
No skills found in repository

also with this
npx ai-agent-skills install alirezarezvani/claude-skills

Cloning alirezarezvani/claude-skills...
No skills found in repository
Cloning alirezarezvani/claude-skills...
No skills found in repository
Cloning alirezarezvani/claude-skills...
No skills found in repository
Cloning alirezarezvani/claude-skills...
....

OpenAI Codex (v0.87.0)

[TylonHH]

your repo should follwing the guideline for skills:

your-skill-library/
├── README.md                          # Overview of all skills
├── skills/                            # Main skills directory
│   ├── skill-name-1/                  # Individual skill folder
│   │   ├── SKILL.md                   # Main agent instructions (REQUIRED)
│   │   ├── README.md                  # Human-readable documentation
│   │   ├── metadata.json              # Skill metadata (optional)
│   │   ├── rules/                     # Rule files (if skill is rule-based)
│   │   │   ├── _sections.md          # Section metadata
│   │   │   ├── _template.md          # Template for new rules
│   │   │   └── area-description.md   # Individual rules
│   │   ├── scripts/                   # Helper scripts (optional)
│   │   ├── references/                # Supporting docs (optional)
│   │   └── AGENTS.md                  # Compiled output (if generated)
│   │
│   ├── skill-name-2/
│   │   ├── SKILL.md
│   │   └── ... 
│   │
│   └── skill-name-n. zip              # Skills can also be zipped
│
├── packages/                          # Build tools and utilities (optional)
│   └── ... 
│
└── . github/                           # GitHub workflows (optional)

but in your repo there is no sklill folder.

[alirezarezvani]

✅ Issue Resolved

This issue has been addressed in PR #43, which adds OpenAI Codex support without restructuring the existing repository.

Solution Implemented

Instead of moving skills to a skills/ directory (which would break existing Claude Code users), we created a symlink layer at .codex/skills/ that provides Codex-compatible skill discovery while preserving the domain-based organization.

What's Included

• .codex/skills/ - 43 symlinks pointing to actual skill folders
• .codex/skills-index.json - Skills manifest with metadata
• scripts/codex-install.sh - Unix installation script
• scripts/codex-install.bat - Windows installation script
• scripts/sync-codex-skills.py - Automation to regenerate symlinks
• GitHub workflow - Auto-syncs when skills are added/modified

Installation Methods

Universal Installer:

npx ai-agent-skills install alirezarezvani/claude-skills --agent codex

Direct Script:

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/codex-install.sh

Manual:

mkdir -p ~/.codex/skills
cp -rL .codex/skills/* ~/.codex/skills/

Verification

Skills install to ~/.codex/skills/ with proper structure:

~/.codex/skills/
├── content-creator/
│   ├── SKILL.md
│   ├── scripts/
│   └── references/
├── senior-fullstack/
└── ... (43 skills)

Documentation

• README.md - How to Use with OpenAI Codex
• INSTALLATION.md - OpenAI Codex Installation

Once PR #43 is merged, this will be available on the main branch. Please let us know if you have any questions or need further assistance!