Individual skill

codex-theme-studio

Design, install, switch, verify, repair, pause, or restore reversible themes for the official Codex Desktop app on macOS. Use when a user asks to change Codex fonts, colors, artwork, homepage banners, radii, density, selection states, or advanced layout; reuse a bundled preset; diagnose a failed skin injection; or return to the official appearance. Do not use for Windows, Linux, ChatGPT web, ZCode, Doubao Work, third-party Codex builds, or direct app.asar modification.

skills/codex-theme-studio/SKILL.md

Read pinned source

Source commit d09cc28cd0915808534ea3bf199f17efa75553a6

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Network or broad shell
Last checked: Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 787
Repository last updated: Nov 6, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

design Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

LICENSEasset · 1,093 bytes
NOTICE.mddoc · 1,830 bytes
SKILL.mdcore · 5,631 bytes
UPSTREAM_COMMITasset · 41 bytes
VERSIONasset · 6 bytes
agents/interface.yamlasset · 246 bytes
agents/openai.yamlasset · 294 bytes
assets/base-codex-theme.txtdoc · 295 bytes
assets/dream-skin.cssasset · 20,029 bytes
assets/generic-workflow.pngasset · 59,093 bytes
assets/generic-workflow.svgasset · 2,198 bytes
assets/renderer-inject.jsruns · 13,429 bytes
assets/theme.jsonasset · 1,060 bytes
evals/history/2026-09-04-v1.2.0.jsonasset · 780 bytes
evals/output/cases.jsonlasset · 2,961 bytes
evals/trigger_cases.jsonasset · 754 bytes
manifest.jsonasset · 1,106 bytes
package-lock.jsonasset · 250 bytes
package.jsonruns · 233 bytes
presets/graphite-paper/generic-workflow.pngasset · 59,093 bytes
presets/graphite-paper/preset.jsonasset · 201 bytes
presets/graphite-paper/theme.jsonasset · 1,060 bytes
presets/zhijian-ai/portal-hero-v2.pngasset · 1,755,792 bytes
presets/zhijian-ai/preset.jsonasset · 408 bytes
presets/zhijian-ai/theme.jsonasset · 1,066 bytes
references/asset-provenance.mddoc · 2,854 bytes
references/capability-boundary.mddoc · 1,508 bytes
references/compatibility-policy.mddoc · 1,399 bytes
references/design-workflow.mddoc · 3,095 bytes
references/imagegen-assets.mddoc · 2,953 bytes
references/operator-runbook.mddoc · 3,476 bytes
references/output-eval-baseline.mddoc · 1,261 bytes
references/preset-policy.mddoc · 1,243 bytes
references/provenance.mddoc · 852 bytes
references/qa-inventory.mddoc · 3,574 bytes
references/safety-and-rollback.mddoc · 3,452 bytes
references/theme-schema.mddoc · 1,628 bytes
references/troubleshooting.mddoc · 2,790 bytes
references/verification-contract.mddoc · 2,668 bytes
scripts/audit-skill-package.mjsruns · 2,897 bytes
scripts/base-theme-state.mjsruns · 6,408 bytes
scripts/common-macos.shruns · 21,894 bytes
scripts/customize-theme-macos.shruns · 4,737 bytes
scripts/doctor-macos.shruns · 3,081 bytes
scripts/import-preset-macos.shruns · 1,646 bytes
scripts/injector.mjsruns · 51,138 bytes
scripts/install-dream-skin-macos.shruns · 6,867 bytes
scripts/install-resident-manager-macos.shruns · 3,010 bytes
scripts/list-presets.mjsruns · 1,515 bytes
scripts/load-image-theme-macos.shruns · 4,051 bytes
scripts/pause-dream-skin-macos.shruns · 2,305 bytes
scripts/resident-manager-macos.shruns · 2,134 bytes
scripts/restore-dream-skin-macos.shruns · 2,208 bytes
scripts/restore-version-macos.shruns · 1,568 bytes
scripts/start-dream-skin-macos.shruns · 4,807 bytes
scripts/status-dream-skin-macos.shruns · 3,041 bytes
scripts/switch-theme-macos.shruns · 2,021 bytes
scripts/theme-config.mjsruns · 5,714 bytes
scripts/verification-contract.mjsruns · 12,849 bytes
scripts/verify-dream-skin-macos.shruns · 1,494 bytes
scripts/version-backup-state.mjsruns · 16,889 bytes
scripts/write-theme.mjsruns · 5,146 bytes
security/network_policy.jsonasset · 1,005 bytes
security/permission_policy.jsonasset · 2,695 bytes
security/trust-baseline.mddoc · 3,232 bytes
skill-ir/examples/codex-theme-studio.jsonasset · 5,958 bytes
tests/base-theme-state.test.mjsruns · 3,008 bytes
tests/fixtures/v3-degraded-state.jsonasset · 1,659 bytes
tests/fixtures/v3-home-state.jsonasset · 2,898 bytes
tests/fixtures/v3-system-state.jsonasset · 1,250 bytes
tests/fixtures/v3-task-state.jsonasset · 2,323 bytes
tests/resident-manager.test.mjsruns · 2,128 bytes
tests/run-tests.shruns · 6,794 bytes
tests/skill-package.test.mjsruns · 2,463 bytes
tests/verifier-contract.test.mjsruns · 12,460 bytes
tests/version-backup-state.test.mjsruns · 9,996 bytes
tests/zhijian-theme.test.mjsruns · 12,100 bytes

Read excerpt


# Codex Theme Studio

Turn a visual direction, brand system, or supplied image into a reversible Codex Desktop theme through loopback-only Chrome DevTools injection.

## Modes

- **Design**: prepare a portable theme directory and validate it without installing or restarting Codex.
- **Apply**: run the safety preflight, install the runtime, and import or create a theme. Obtain explicit authorization before restarting a running Codex app.
- **Verify or repair**: reproduce the affected route, run deterministic tests, Doctor, and live Verify, then repair only selector or layout failures supported by evidence.
- **Pause or restore**: Pause removes the active styling. Restore also stops the managed CDP session and returns Codex to the official appearance.

## Workflow

1. Read [capability-boundary.md](references/capability-boundary.md). Confirm the official macOS host, authorization boundary, and excluded targets.