# Codex2claude

> Synchronize Codex user skills into Claude Code. Auto-discovers the Claude environment and syncs from %USERPROFILE%\.codex\skills into the Claude skills folder. Supports full sync and single-skill sync. Excludes Codex built-in .system and accepts both skill.md and SKILL.md.

- **Type:** Skill
- **Install:** `agentstack add skill-phanghonghao-thu-awesome-skills-codex2claude`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [phanghonghao](https://agentstack.voostack.com/s/phanghonghao)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [phanghonghao](https://github.com/phanghonghao)
- **Source:** https://github.com/phanghonghao/THU-Awesome-Skills/tree/main/skills/codex2claude

## Install

```sh
agentstack add skill-phanghonghao-thu-awesome-skills-codex2claude
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Codex to Claude (codex2claude)

Synchronize user-created Codex skills into Claude Code.

## Scope

- Source: `%USERPROFILE%\.codex\skills`
- Exclude from source: `%USERPROFILE%\.codex\skills\.system`
- Target: Claude user skills folder, auto-discovered from the local Claude environment
- Default target fallback: `%USERPROFILE%\.claude\skills`

Default behavior is to sync **user/custom Codex skills only**. Do **not** copy Codex built-in `.system` into Claude.

The sync logic should treat both `SKILL.md` and `skill.md` as valid skill entry files. When copying to Claude, normalize to `SKILL.md` so skill discovery is more reliable across environments.

## When To Use

Use this skill when the user asks to:

- sync Codex skills to Claude
- update Claude skills from Codex
- replace a Claude skill with the Codex version
- copy one specific skill from Codex to Claude

## Modes

### Full Sync

For requests like:

- "sync all Codex skills to Claude"
- "update Claude skills from Codex"

Run:

```powershell
powershell -ExecutionPolicy Bypass -File "\scripts\sync-skills.ps1" -Mode full
```

Behavior:

- Creates a backup of existing Claude user skills
- Removes all Claude target skills
- Copies all Codex user skills except `.system`
- Resolves junction/source links by copying real contents
- Normalizes `skill.md` to `SKILL.md` when needed
- Verifies sync result before cleaning up backup

### Single Skill Sync

For requests like:

- "sync github-trending to Claude"
- "update md2tex skill to Claude"

Run:

```powershell
powershell -ExecutionPolicy Bypass -File "\scripts\sync-skills.ps1" -Mode single -SkillName github-trending
```

Behavior:

- Backs up the current Claude copy of that skill if it exists
- Replaces only that one target skill
- Normalizes `skill.md` to `SKILL.md` when needed
- Verifies sync result before cleaning up backup

## Output Handling

The script prints a JSON summary. Report to the user:

- mode used
- source and target paths
- backup path
- synced skills
- skipped items
- any errors

## Notes

- Do not copy `%USERPROFILE%\.codex\skills\.system`
- First try to detect Claude via `where claude`, then use the matching user Claude data directory
- Treat `%USERPROFILE%\.codex\skills` as the source of truth for Codex user skills
- If a skill exists as a junction/link, copy the real target contents
- `skill.md` and `SKILL.md` should both be accepted as source files
- Prefer writing `SKILL.md` in Claude targets

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [phanghonghao](https://github.com/phanghonghao)
- **Source:** [phanghonghao/THU-Awesome-Skills](https://github.com/phanghonghao/THU-Awesome-Skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-phanghonghao-thu-awesome-skills-codex2claude
- Seller: https://agentstack.voostack.com/s/phanghonghao
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.