From d7198a5f756dccd8e29276b3b5fcd21407a39609 Mon Sep 17 00:00:00 2001 From: huaerze Date: Wed, 22 Jul 2026 09:31:05 +0800 Subject: [PATCH] Add Codex skin pack installer skill --- README.md | 1 + .../codex-skin-pack-installer/SKILL.md | 41 +++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 skills/frontend/codex-skin-pack-installer/SKILL.md diff --git a/README.md b/README.md index 7525475..7ac71f4 100644 --- a/README.md +++ b/README.md @@ -59,6 +59,7 @@ Skills are organized by domain under `skills/`. Each skill is a folder with a `S - [`accessibility-basic-check`](skills/frontend/accessibility-basic-check/SKILL.md): Check contrast, labels, focus order, and keyboard navigation for regressions. - [`css-layout-helper`](skills/frontend/css-layout-helper/SKILL.md): Diagnose layout intent and provide minimal flex/grid fixes with rationale. - [`cli-ux-improver`](skills/frontend/cli-ux-improver/SKILL.md): Improve CLI defaults, help text, and errors with actionable next steps. +- [`codex-skin-pack-installer`](skills/frontend/codex-skin-pack-installer/SKILL.md): Install, verify, apply, switch, and restore public-safe Codex desktop skin packs. ### Backend - [`caching-strategy-helper`](skills/backend/caching-strategy-helper/SKILL.md): Choose cache type, TTLs, and invalidation triggers based on freshness needs. diff --git a/skills/frontend/codex-skin-pack-installer/SKILL.md b/skills/frontend/codex-skin-pack-installer/SKILL.md new file mode 100644 index 0000000..40f79b3 --- /dev/null +++ b/skills/frontend/codex-skin-pack-installer/SKILL.md @@ -0,0 +1,41 @@ +--- +name: codex-skin-pack-installer +description: Install, validate, apply, switch, and restore Codex desktop skin packs. Use when a developer wants to customize Codex safely without modifying app files or leaking private workspace screenshots. +--- + +# Codex Skin Pack Installer + +## Purpose +Help a developer install and test public-safe Codex desktop skin packs with a reversible workflow. + +## Inputs to request +- Operating system and whether the official Codex desktop app is installed. +- Desired skin slug, for example `caishen-readable` or `mythic-guardian-noir`. +- Whether they want a temporary preview, a persistent apply, or a full restore. + +## Workflow +1. Start with safety: confirm this is an unofficial skin pack, avoid private screenshots, and explain the restore path before applying anything. +2. Prefer the maintained install route: + ```bash + npx skills add ChannelerH/codex-skin-packs --skill codex-skin-pack-installer --global --agent codex --yes + ``` +3. Ask Codex to use the installed skill for the requested skin: + ```text + Use $codex-skin-pack-installer to install the caishen-readable Codex skin pack and tell me how to restore the default theme. + ``` +4. Verify the skin package before applying it: check that `theme.json`, assets, and restore guidance are present, and that the pack does not contain private workspace screenshots. +5. Apply or preview the skin only after verification, then confirm the user can still read sidebar text, task output, diffs, and composer input. +6. If the user reports readability, persistence, or restart issues, switch to the previous known-good skin or restore the default theme first, then debug. + +## Output +- Exact install command. +- The selected skin slug and source URL. +- Verification result and any safety warnings. +- Apply/preview status. +- Restore command or plain-language restore steps. + +## Quality bar +- Do not claim OpenAI affiliation. +- Do not publish or reuse private Codex screenshots. +- Prefer reversible changes and one-command restore paths. +- Treat readability as a hard requirement, not a visual preference.