# How to add Subclip agent skills to OpenAI Codex

Install the Subclip agent skills for the Codex CLI, app or IDE extension with one command, connect the Subclip MCP server and verify the skills.

Canonical URL: https://www.subclip.app/agent-skills/install/codex

Support: One command. The Subclip skills installer writes straight into the folder this agent reads.

The installer has a codex target that writes to ~/.codex/skills. Use --target agents instead if you keep your Codex skills in the portable ~/.agents/skills folder.

## Steps

1. Run npx @subclip/skills install --target codex.
2. Use --target all to install for Claude Code, Codex and the portable folder in one run.
3. Open the Subclip app, go to Desktop settings > Connect AI client and add the Subclip MCP server to Codex. The skills call tools that the running app serves.
4. Restart Codex or start a new session so it picks up the new skill folders.

## Commands

macOS and Linux:

```sh
npx @subclip/skills install --target codex
```

## Skill folders

- Personal (--target codex): `~/.codex/skills/<skill-name>/SKILL.md`
- Portable (--target agents): `~/.agents/skills/<skill-name>/SKILL.md`

## Check that it works

- Type $subclip-video-editor and describe the edit you want.
- Run /skills in the CLI or IDE extension to confirm the Subclip skills were found.

## Limits

- Codex may shorten the skill list when many skills are installed. Name the skill when it is not picked automatically.
- A skill does not bypass the sandbox, network or approval settings.

Official OpenAI Codex docs: https://learn.chatgpt.com/docs/build-skills