qcrao Find Codex themes
Search the public catalog, show several relevant choices, and route the selected item to the correct next action. Do not treat concept art as an installable theme or static validation as live verification.
Search
Run from this Skill directory:
node scripts/find_themes.mjs <style subject mood...> --lang <en|zh> --limit 5
Use --verified when the user explicitly requests tested themes and
--installable when they want something that can be applied immediately.
Run one broader query when the first query has no close results; do not loop on
the same terms.
The default catalog is https://www.codexskins.org/api/themes.json. Read
references/catalog-schema.md only when diagnosing schema or result-routing
problems. For staging or local validation, pass --catalog /absolute/catalog.json
or set CODEXSKINS_CATALOG_URL; never substitute an untrusted catalog during a
normal user install flow.
Present results
Show up to five candidates. For each include:
- id, localized name, description, and tags
- public detail-page URL
- verification status and tested platforms
- whether a
.codedrobe-themepackage is installable - the catalog guidance
Display the preview image when the client supports images. Download it to a temporary directory first instead of writing it into the user's workspace.
Continue the workflow
installable: true: offer to install and apply the id withcodedrobe-theme-manager.- bundled Dream Skin preset: link the detail page and the matching platform guide; do not pretend it is a CodeDrobe package.
- design-only skin: offer to recreate the look with
codedrobe-one-shot-themeusing the preview as art direction. - community theme without a hosted package: link the source/detail page and do not scrape or redistribute the author's file.
Never end with a result list when an obvious next action exists. Ask which id the user wants only when several choices are genuinely close.