{
  "markdown": "# CodexThemes Skills\n\nOfficial agent skills for creating cohesive, native-safe themes for the Codex desktop app, and for finding, installing, and submitting themes on [codexthemes.ai](https://codexthemes.ai).\n\nThe repository is the canonical source for the skill served through [codexthemes.ai/SKILL.md](https://codexthemes.ai/SKILL.md). It contains no bundled celebrity images, third-party themes, copied screenshots, generated theme packages, or private user assets.\n\n## Install\n\nInstall `codex-theme-creator` globally for Codex:\n\n```bash\nnpx skills add codexthemes/skills --skill codex-theme-creator -g -a codex\n```\n\nInstall it in the current project instead:\n\n```bash\nnpx skills add codexthemes/skills --skill codex-theme-creator -a codex\n```\n\nInstall `codex-theme-submitter` to submit exported `.codex-theme` packages through the codexthemes.ai API:\n\n```bash\nnpx skills add codexthemes/skills --skill codex-theme-submitter -g -a codex\n```\n\nInstall `codex-theme-finder` and `codex-theme-installer` to search the codexthemes.ai gallery and install published themes locally:\n\n```bash\nnpx skills add codexthemes/skills --skill codex-theme-finder -g -a codex\nnpx skills add codexthemes/skills --skill codex-theme-installer -g -a codex\n```\n\nInstall `codex-theme-switcher` to apply, switch, and restore installed themes with one command:\n\n```bash\nnpx skills add codexthemes/skills --skill codex-theme-switcher -g -a codex\n```\n\nInstall `workbuddy-theme-manager` to convert `.codex-theme` packages into the standalone `.workbuddy-theme` format and apply them to Tencent WorkBuddy without a third-party theme runtime:\n\n```bash\nnpx skills add codexthemes/skills --skill workbuddy-theme-manager -g\n```\n\nList the skills available in this repository:\n\n```bash\nnpx skills add codexthemes/skills --list\n```\n\nUpdate an installed copy:\n\n```bash\nnpx skills update codex-theme-creator\n```\n\nYou can also give an agent this URL directly:\n\n```text\nhttps://codexthemes.ai/SKILL.md\n```\n\nThe website entrypoint tells the agent to load the canonical skill and required references from this repository.\n\n## Use\n\nExamples:\n\n```text\nUse $codex-theme-creator to create a light Codex theme from this reference image. Keep the native layout and use the artwork only on the home page.\n```\n\n```text\nUse $codex-theme-creator to create a native-immersive theme. Show the background on conversations too, and verify settings, menus, diffs, terminal, sidebar hover states, and narrow windows.\n```\n\nThe skill defaults to preserving the native layout. It supports four explicit modes:\n\n- `native-background`: change only scoped artwork and readability veils.\n- `native-immersive`: preserve geometry while coordinating all semantic surfaces.\n- `editorial-showcase`: allow a bounded home hero when the reference requires it.\n- `palette-only`: change semantic colors and materials without dominant artwork.\n\nTheme creation, validation, session application, and restore are self-contained TypeScript workflows. They do **not** require CodeDrobe, Dream/Fiona, or another theme application. The runtime uses Node.js and Codex's loopback-only debugging endpoint, never patches the signed app bundle, and may need to be applied again after a full app quit. The launcher supports macOS and Windows; builds that drop the Chromium debugging flags (for example some store packages) cannot be themed and are reported as such.\n\nBy default, editable themes live in `~/.codexthemes/themes/<id>/`, shareable packages in `~/.codexthemes/exports/<id>.codex-theme`, and runtime state in `~/.codexthemes/state/`.\n\n`codex-theme-submitter` publishes an exported `.codex-theme` package to CodexThemes:\n\n```text\nUse $codex-theme-submitter to submit ~/.codexthemes/exports/my-theme.codex-theme to codexthemes.ai.\n```\n\nIt checks for a local CodexThemes API key (`CODEXTHEMES_API_KEY` or `~/.codexthemes/credentials.json`), guides you to create one at [codexthemes.ai/settings/apikeys](https://codexthemes.ai/settings/apikeys) when none exists, validates the package with a dry run, and then submits it to the authenticated `POST /api/themes/submit` endpoint.\n\n`codex-theme-finder` searches the published gallery, and `codex-theme-installer` downloads a theme's source files into `~/.codexthemes/themes/<id>/`:\n\n```text\nUse $codex-theme-finder to search codexthemes.ai for a dark anime Codex theme.\n```\n\n```text\nUse $codex-theme-installer to install https://codexthemes.ai/themes/noir-anime locally.\n```\n\nBoth work anonymously within a free API quota; when the quota or rate limit is hit (HTTP 429), they guide you to create an API key at [codexthemes.ai/settings/apikeys](https://codexthemes.ai/settings/apikeys) for higher limits. Installing places source files only.\n\n`codex-theme-switcher` activates themes: it lists the local library, hot-swaps the running app when the debugging endpoint is live, schedules a restart-surviving relaunch when it is not (or when `--relaunch` forces a clean restart), verifies the result against the real DOM, and restores the native look:\n\n```text\nUse $codex-theme-switcher to switch my Codex theme to noir-anime.\n```\n\n`workbuddy-theme-manager` provides a separate, self-contained WorkBuddy path. It converts either a `.codex-theme` package or an installed `~/.codexthemes/themes/<id>/` source into WorkBuddy-specific CSS, writes packages under `~/.codexthemes/workbuddy-exports/`, and owns its loopback-only CDP injection and restore lifecycle:\n\n```text\nUse $workbuddy-theme-manager to convert ~/.codexthemes/exports/noir-anime.codex-theme and apply it to WorkBuddy.\n```\n\nFor a theme downloaded by `codex-theme-installer`, no intermediate export is needed:\n\n```text\nUse $codex-theme-installer to install portal-panic, then use $workbuddy-theme-manager to convert the installed theme and apply it to WorkBuddy.\n```\n\n## Repository layout\n\n```text\nskills/codex-theme-creator/\n├── SKILL.md\n├── agents/openai.yaml\n├── assets/\n├── references/\n└── scripts/\nskills/codex-theme-submitter/\n├── SKILL.md\n├── agents/openai.yaml\n├── references/\n└── scripts/\nskills/codex-theme-finder/\n├── SKILL.md\n├── agents/openai.yaml\n├── references/\n└── scripts/\nskills/codex-theme-installer/\n├── SKILL.md\n├── agents/openai.yaml\n├── references/\n└── scripts/\nskills/codex-theme-switcher/\n├── SKILL.md\n├── agents/openai.yaml\n└── scripts/\nskills/workbuddy-theme-manager/\n├── SKILL.md\n├── agents/openai.yaml\n├── assets/\n├── references/\n└── scripts/\n```\n\nThe root README is for people. Each directory inside `skills/` is a standalone installable agent skill.\n\n> This skill was previously named `new-theme`. Reinstall it using the new name and remove the old local directory if both versions are present; keeping both can make Skill routing ambiguous.\n\n## Validation\n\n```bash\nnpm ci\nnpm run check\n```\n\n`npm run check` runs strict TypeScript type checking, validates Agent Skill metadata with the bundled TypeScript validator, and tests every scaffold mode plus static theme rejection rules. The repository does not require Python.\n\n## Content and rights policy\n\n- Source, documentation, and templates in this repository are Apache-2.0 licensed unless a file states otherwise.\n- No third-party binary artwork is included.\n- User-supplied material may be used directly for local theme creation and export.\n- Sharing permission is confirmed by the uploader during submission; the Skill does not perform legal or copyright review.\n- “Codex” and “OpenAI” are trademarks of their respective owners. This project is independent and is not endorsed by OpenAI.\n\nSee [NOTICE](NOTICE) and [skills/codex-theme-creator/references/asset-rights.md](skills/codex-theme-creator/references/asset-rights.md).\n\n## License\n\nApache License 2.0. See [LICENSE](LICENSE).\n",
  "bytes": 7689,
  "sha": "5f3ead7d321cf8c6028013bcf377289f424915e26e49bb3ec363dc3fd2a6c072",
  "repo_slug": "codexthemes/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_codexthemes_skills_codex_theme_switcher_6af63bfc/readme"
}