Codex Skill

Install Codex skin packs through your agent.

Codex Skin Pack Installer is a public Codex Skill for users who want a real install path, not a fake preview. It downloads skin packs from GitHub releases, validates theme.json and background.png, stages the files locally, and keeps restore guidance in the workflow.

Fast path

Start with Caishen Readable

Traffic from Codex theme lists is already landing on this installer. Caishen Readable is the lowest-friction pack to try first because it keeps text readable and has a direct theme page, zip, and fetch command.

Direct fetch

Fetch this pack after installing the Skill

This skips the catalog step for visitors who already know they want the readable Caishen pack.

python3 "$CODEX_SKILL_DIR/scripts/fetch_skin_pack.py" caishen-readable
Restore-first

Keep rollback visible

Use the installer to stage files, then apply the pack with your active Codex skin manager. Verify Home, Task, Diff, and Composer before keeping the theme.

Windows users

Theme Inject package path

If you use `codecnmc/codex-theme-inject`, Caishen Readable is under upstream review as a downloadable example theme.

Theme authors

ReTheme source package path

If you are building ReTheme packages, inspect the Caishen Readable source example before packaging your own desktop theme.

Dream Skin users

Bundled preset path

If you already use Codex Dream Skin, review the macOS preset proposal or download the public pack directly.

1

Install the Skill

Use the Codex plugin path for the lowest-friction install. If you already use the standard Agent Skills CLI, the same Skill also installs with `npx skills`.

codex plugin marketplace add ChannelerH/codex-skin-packs --ref main --sparse .agents/plugins --sparse plugins/codex-skin-pack-installer
codex plugin add codex-skin-pack-installer@codex-skin-packs
npx skills add ChannelerH/codex-skin-packs --skill codex-skin-pack-installer --global --agent codex --yes
2

Ask Codex to stage a pack

Start with Caishen Lite or list the available packs. The helper script validates the package before the theme is applied.

Use $codex-skin-pack-installer to install the caishen-readable Codex skin pack and tell me how to restore the default theme.
3

Apply, verify, restore

After staging, use Codex Dream Skin or your active theme manager to apply the pack. Verify Home, Task, Diff, and Composer readability, then keep the restore path before continuing work.

Why this exists

A better acquisition path than screenshots.

Users arriving from GitHub lists or search need an action they can run immediately. This page gives them the install command, the first prompt, the release downloads, and the safety model in one place.