# Codexskin Theme Finder

> Search and compare public CodexSkin themes and visual skin inspirations, anonymously by default and with an optional key only for higher limits.

- Skill: `yunhe-dev/codexskin-theme-finder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yunhe-dev/codexskin-theme-finder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yunhe-dev/codexskin-theme-finder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yunhe-dev (https://skillmd.com/u/yunhe-dev)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yunhe-dev/codexskin-theme-finder

---


# Find CodexSkin themes

Run `node scripts/codexskin.mjs find [style, subject, mood]`.

Use `https://codexskin.cool` unless the user explicitly supplies another API
base. Do not request an API key for ordinary search. `CODEXSKIN_API_KEY` is
optional and only raises rate limits.

Present no more than five useful results with id, kind, author, description,
detail URL, and a locally downloaded preview suitable for displaying in chat.
Downloaded previews are cached under `~/.codexskin/cache/previews/`; an
unavailable CDN preview must not prevent the search results themselves from
being returned.
Explain each next step:

- installable Theme → offer Installer and then Switcher;
- non-installable Theme → share its detail URL for manual handling;
- Skin → visual reference only; offer Creator using its preview image.

Always share the detail URL. When the user selects an installable theme, hand
off to `$codexskin-theme-installer`; do not claim search itself installed it.