---
slug: "codex-plugin-discovery"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/caozhangni/codex-plugin-discovery@main/README.md"
repo: "https://github.com/caozhangni/codex-plugin-discovery"
source_file: "README.md"
branch: "main"
---
# Codex Plugin Discovery

Codex Plugin Discovery is a Codex skill that helps find task-relevant Codex plugins from two official OpenAI plugin repositories:

- `openai/plugins`
- `openai/role-based-plugins`

It is intentionally scoped to metadata generated from those repositories. It does not read local Codex plugin caches, does not inspect the full Codex App Plugin Directory, and does not install plugins automatically.

## Install As A Skill

In Codex, invoke Skill Installer with the GitHub skill path:

```text
@Skill Installer https://github.com/caozhangni/codex-plugin-discovery/tree/main/skills/codex-plugin-discovery
```

Or run the installer script directly:

```bash
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --url https://github.com/caozhangni/codex-plugin-discovery/tree/main/skills/codex-plugin-discovery
```

Restart Codex after installing so the skill metadata is picked up.

## Use

Ask for plugin recommendations with a task or category:

```text
What Codex plugin could help me make a slide deck?
```

```text
Find a Codex plugin for analyzing spreadsheets.
```

Ask for recently added plugins:

```text
What Codex plugins were added in the past 14 days?
```

Ask what a specific plugin does:

```text
What does the Google Drive plugin do?
```

Broad questions such as "what plugins can I use?" are answered concisely. The skill does not dump the full index.

## Update The Index

The generated index is stored at:

```text
skills/codex-plugin-discovery/index/plugins-index.json
```

Regenerate it with:

```bash
cd skills/codex-plugin-discovery
python3 scripts/build_index.py --cache-dir .cache --output index/plugins-index.json
rm -rf .cache
```

The builder reads git history from both source repositories so each direct plugin manifest records when it first appeared in its own repository. That first-seen metadata powers recent-plugin queries.

## Distribute As A Plugin

This repository also includes a plugin package at:

```text
plugins/codex-plugin-discovery
```

The plugin bundles the same skill under `plugins/codex-plugin-discovery/skills/codex-plugin-discovery`.

## Verify

Run the skill tests:

```bash
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s skills/codex-plugin-discovery/tests -v
```

Validate the skill and plugin manifests:

```bash
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/codex-plugin-discovery
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/codex-plugin-discovery
```

## License

MIT