Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
41 changes: 41 additions & 0 deletions skills/frontend/codex-skin-pack-installer/SKILL.md
Original file line number Diff line number Diff line change
@@ -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.