Find Skill

Find Skill

Overview

Use this skill to discover installable Codex skills without scraping the website by hand. Prefer the bundled script because it reads the GitHub catalog metadata, ranks matches, marks already installed skills, and prints safe install commands.

Primary source:

• Website: https://skillregistry.dev/
• Catalog repo: https://github.com/vadimcomanescu/codex-skills
• Installer CLI: npx codex-skills-registry@latest

Workflow

1. Search or list skills with scripts/find_skill.py.
2. Show the user the best matches with category/slug, tier, description, and whether it is already installed.
3. If the user wants installation, install only the explicit category/slug they chose.
4. After installing, tell the user to restart Codex.
5. If this machine uses a skills mirror repository, ask or proceed according to the user's request before syncing and pushing mirror changes.

Commands

Search:

python ~/.codex/skills/find-skill/scripts/find_skill.py "code review"

List by category:

python ~/.codex/skills/find-skill/scripts/find_skill.py --list --category quality

Get JSON for automation:

python ~/.codex/skills/find-skill/scripts/find_skill.py "frontend" --json

Install an explicit skill:

python ~/.codex/skills/find-skill/scripts/find_skill.py --install quality/code-reviewer --yes

The script uses the same installer the website documents:

npx codex-skills-registry@latest --skill=quality/code-reviewer --yes

Selection Guidance

• Prefer curated skills for ordinary recommendations.
• Include experimental skills when the user's request is niche or no curated skill fits.
• For security-sensitive workflows, inspect the selected SKILL.md before installing or recommending broad usage.
• Do not install multiple skills unless the user explicitly asks for a set.
• Do not treat skillregistry.dev as official OpenAI content; describe it as a community catalog.

Notes

• The website currently exposes browsing and CLI commands; the GitHub repo is the more stable machine-readable source.
• The installer supports --owner, --repo, and --ref; use these only when the user asks to search a fork or pinned ref.
• GITHUB_TOKEN can be set for higher GitHub API rate limits, but the script does not require it for normal use.