Agent skill

Heige Codex Skin Studio

by HeiGeAi in HeiGeAi/heige-codex-skin-studio

A skill your agent uses when 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤。

MITAuto-check passed

Install Heige Codex Skin Studio

skills CLI
$ npx skills add HeiGeAi/heige-codex-skin-studio --skill heige-codex-skin-studio -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HeiGeAi/heige-codex-skin-studio heige-codex-skin-studio --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HeiGeAi/heige-codex-skin-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/heige-codex-skin-studio .claude/skills/heige-codex-skin-studio && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
heige-codex-skin-studio
GitHub stars
478
Token cost
~1.5k tokens
SKILL.md length
351 words
Files
5 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤。

  • Works in 5 steps: 先确认当前是 macOS 还是 Windows,只运行对应平台的入口。 → 安装阶段跳过自动应用,先让安装交易完整结束。 → status 是只读检查。不得用 apply、enable-skin… → …
  • 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤
  • SKILL.md covers 必须遵守, 首次安装, 应用与常驻语义 and 内置预设与菜单自定义, plus 5 more sections
  • Runs Batch and PowerShell scripts from its folder

What it does

Heige Codex Skin Studio is an agent skill from HeiGeAi/heige-codex-skin-studio. Use when 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `README.md`).

It works with macOS and OpenAI. The repository describes itself as: 给 Codex Desktop 一键换肤:OpenAI Codex / ChatGPT 桌面端主题工具,CDP 注入零修改应用,13 套内置预设(Miku / 原神 / 鸣潮 / 火影 / 恋与深空 / 龙珠 / 财神)+ 自定义图片取色,支持 macOS 与 Windows | One-click theme & skin switcher for…. The licence is MIT.

When your agent uses it

  • 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤

Example prompts

  • “/heige-codex-skin-studio”

Requirements

  • Node.js
  • PowerShell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 先确认当前是 macOS 还是 Windows,只运行对应平台的入口。
  2. 安装阶段跳过自动应用,先让安装交易完整结束。
  3. status 是只读检查。不得用 apply、enable-skin 或重启来代替状态检查。
  4. 执行启用或完整恢复前,先告知用户 Codex 可能正常重启。以脚本返回的 ACK 或明确错误为准,不把「看到重启」当成成功证据。
  5. 失败后不做无界重试。保留原错误与 doctor 输出,再决定下一步。

What it can do on your machine

Read from SKILL.md and the folder at commit a6fa398. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Batch and PowerShell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Heige Codex Skin Studio loads about 1.5k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 351 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from HeiGeAi/heige-codex-skin-studio at commit a6fa398, republished under its MIT licence (© HeiGeAi). 351 words, ~1,462 tokens.

Download SKILL.mdSave it as .claude/skills/heige-codex-skin-studio/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
heige-codex-skin-studio
description
Use when 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤。

HeiGe Codex Skin Studio

通过本机 CDP 注入为 Codex Desktop 换肤,不修改 app.asar、应用签名或二进制文件。同一引擎支持给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤,见「WorkBuddy 支持」一节。

必须遵守

  1. 先确认当前是 macOS 还是 Windows,只运行对应平台的入口。
  2. 安装阶段跳过自动应用,先让安装交易完整结束。
  3. status 是只读检查。不得用 apply、enable-skin 或重启来代替状态检查。
  4. 执行启用或完整恢复前,先告知用户 Codex 可能正常重启。以脚本返回的 ACK 或明确错误为准,不把「看到重启」当成成功证据。
  5. 失败后不做无界重试。保留原错误与 doctor 输出,再决定下一步。

首次安装

macOS:

bash
HEIGE_SKIP_APPLY=1 "$HOME/.agents/skills/heige-codex-skin-studio/scripts/install.command"

Windows PowerShell:

powershell
& "$HOME\.agents\skills\heige-codex-skin-studio\scripts\install.ps1" -SkipApply

Windows 用户也可双击 scripts\install.bat。Windows 入口只转发到包内 payload\scripts\windows\install.ps1,不运行 macOS 命令。

默认稳定安装目录:

  • macOS:$HOME/.codex/heige-codex-skin-studio
  • Windows:$HOME\.codex\heige-codex-skin-studio

应用与常驻语义

  • apply:仅应用当前会话,不改变下次启动的常驻选择。
  • 顶部菜单「皮肤常驻」开关是唯一受支持的开启常驻入口。打开后下次启动继续使用;关闭后本次继续使用,下次启动恢复原生界面。
  • 「启用皮肤」与「开启常驻」是两个意图。macOS 打开 $HOME/Applications/HeiGe 皮肤启动器.app 后,可通过固定入口打开或关闭 Codex 与 WorkBuddy 当前皮肤。关闭只暂停当前会话并保留最近主题和常驻选择;一键修复会强制干净重启已安装产品并恢复最近皮肤。
  • enable-skin 和 enable-skin.command 都是 session-only apply 的兼容名,只恢复当前会话,常驻选择保持不变。
  • 用户明确要求常驻时,先用启动器或 apply 恢复当前会话,再提醒用户在顶部菜单显式打开常驻开关。Agent 不得代替用户改成 true。
  • enable-persist.command 是弃用的非零退出入口,不得将它当作上述步骤的替代方案。
  • 启动器未显式指定主题时,优先恢复上次非原生主题,只有没有历史选择时才使用 miku-488137。

macOS 安装必须创建或升级带 Miku 图标的 Schema 5 原生双产品启动器,完成 universal 二进制校验、本地 ad hoc 完整性签名和 LaunchServices 注册。不得把该签名描述成 Apple Developer ID 或公证。启动器不在面板内选择主题,不为 WorkBuddy 开启常驻。打开、关闭和修复必须分别走版本绑定的 launcher-apply、launcher-close、launcher-repair;Codex 固定使用 9341,WorkBuddy 固定使用 9342。启动器只允许对明确的静态 LOCK_CHAIN_CORRUPT 做一次安全恢复:先证明相关服务、进程、锁声明和外来 CDP listener 均不活跃,严格校验状态与用户主题,整体备份旧状态根后再重建。普通锁竞争、未知内容或第二次失败必须停止。失败详情进入受限、轮转的产品日志,用户同时在原生面板看到错误。

macOS 稳定入口是 scripts/launch-skin.command、scripts/close-skin.command、scripts/repair-skin.command、scripts/apply.command、scripts/enable-skin.command、scripts/pause.command、scripts/resume.command 和 scripts/restore.command。Windows 生命周期操作必须使用 scripts\windows 下的同名 .ps1 或 .bat,不得直接运行 Node CLI 代替 Windows Store/MSIX 激活或进程重启。Windows 彻底卸载必须使用 scripts\windows\uninstall.ps1 或 scripts\windows\uninstall.bat;该入口会清理当前用户计划任务、开始菜单、AppData 状态、残留控制器进程和稳定安装目录。若稳定安装目录已被手动删除,从源码目录运行卸载入口清理残留。需要完整退出 Codex/GPT 桌面端时,使用 scripts\windows\close-codex.ps1 或 scripts\windows\close-codex.bat。商店版若报 AppContainer 回环隔离,仅当用户明确允许一次管理员权限时才可调用 scripts\windows\enable-loopback.bat;不得每次 apply 静默提权,也不得复制或改 ACL WindowsApps。

用户意图必须分开:

  • pause 只移除当前会话的皮肤与菜单,不改变常驻选择。
  • resume 只恢复同一个已验证进程中被 pause 暂停的皮肤,不是通用重启入口。
  • restore 关闭常驻、注销后台控制器并恢复原生界面。Codex 已关闭时保持关闭;已是原生状态时不为了恢复而额外启动。
  • close-codex 只安全完整退出已归属的 Codex/GPT 桌面进程并保持关闭,不改常驻、不自动 apply、不自动重启。仅当用户明确允许关闭/退出 Codex 或 GPT 桌面端时才可调用;若用户约束“不要关闭 Codex”,禁止擅自调用。
  • enable-loopback 只给当前商店版 Codex 添加一次 CheckNetIsolation 回环豁免,便于本工具连入已绑定的本机调试端口。仅当用户明确允许一次管理员权限、且报错为回环隔离时才可调用;不得在每次 apply 时静默提权。
  • uninstall 只用于 Windows 完整移除,不等同于 restore。执行前告知用户会删除稳定安装目录和本地状态;不得用 Node CLI 模拟卸载。

内置预设与菜单自定义

默认回退主题是 miku-488137。另有 genshin-dawn、genshin-night、wuthering-tide、wuthering-echo、naruto-hokage、naruto-sasuke、deepspace-dawn、deepspace-star、dragonball-nimbus、dragonball-super-saiyan 和 dalao-dianyan,合计 12 个内置预设。

内置预设会同步 Codex 深浅外观。顶部菜单的「+ 自定义图片」可选择本地图片、自动压缩取色、判断画面亮度并同步 Codex 外观。菜单新上传会写入本机用户主题库,成为正式用户主题并记入启动器,「我的主题」行尾 × 可删除对应磁盘主题。只有旧版 custom-upload 是 renderer 本地兼容槽,新上传不再以该快捷槽作为权威存储。需要从文件或 AI 生成主题时,用 create 生成正式主题。

主题中心的「阅读增强」默认开启,为最终回复和过程回复增加统一的 90% 主题自适应半透明底色与对称留白;用户可随时关闭。该偏好保存在 renderer 本地并同步到其他窗口,不改变皮肤常驻状态,不调用后台接口,也不增加模糊、阴影、观察器或滚动监听。

Show full SKILL.md (144 more words)Show less

状态与诊断

macOS 只读状态:

bash
"$HOME/.codex/heige-codex-skin-studio/scripts/lib/run-cli.zsh" status --port 9341

Windows 只读后台任务状态:

powershell
& "$HOME\.codex\heige-codex-skin-studio\scripts\windows\controller.ps1" -Action status -Port 9341

注入异常时运行 doctor,保留完整 JSON,不循环调用可能触发正常重启的入口。CDP 只允许侦听 127.0.0.1,默认端口是 9341。

图片与主题

用户给出图片时,先验证非空 PNG、JPG、JPEG 或 WebP,再用已验证的 Node.js 22 或更高版本运行:

text
<verified-node> "$ROOT/src/cli.mjs" create --image "<绝对路径>" --name "<主题名>"

从 JSON 返回中读取 id。设为 $id 后,macOS 运行:

bash
"$ROOT/scripts/apply.command" "$id"

Windows PowerShell 运行:

powershell
& "$root\scripts\windows\apply.ps1" -Theme $id -Port 9341

这两个入口都只应用当前会话,不暗中打开常驻。

用户只给创意描述时,先用当前可用的 imagegen 生成横向 UI 主图。为左侧导航和底部输入区留出可读空间,不要把按钮、菜单文字或聊天内容烘焙到图片中。

安装包自带的可选 Miku Future Pet

发布包内自带 Miku Future 动画 Pet,但皮肤安装不会自动启用。仅当用户明确要求安装 Miku Future 时才执行。macOS 优先使用统一 wrapper:

bash
"$ROOT/scripts/install-pet.command"

需要直接调用 CLI 时,使用 <verified-node> "$ROOT/src/cli.mjs" install-pet --source "$ROOT/custom-pet/miku-future"。不因用户只要换肤而自动安装宠物。

WorkBuddy 支持

同一个 Skill 也能给 WorkBuddy(腾讯 CodeBuddy 桌面端)换肤,入口独立,别和 Codex 的混用:

  • 应用:"$ROOT/scripts/workbuddy-apply.command" [--restart] [主题 id]。默认端口 9342;--restart 先安全退出 WorkBuddy 再以调试模式拉起。
  • 还原:"$ROOT/scripts/workbuddy-restore.command"。
  • workbuddy-enable-skin.command 是 workbuddy-apply 的兼容名,只应用当前会话。
  • Node CLI 的等价写法是加 --app workbuddy。
  • WorkBuddy 不支持常驻:set-persistence --app workbuddy 会明确报错。这是刻意的安全决定(file:// renderer 回调控制服务带 Origin: null,不进来源白名单),不得试图绕过来源校验或代用户改配置。重启 WorkBuddy 后皮肤消失属预期,重跑一次 workbuddy-apply 即可。
  • 需要系统 Node.js 22 或更新版本。macOS 在 WorkBuddy 5.3.11 真机验证;Windows 侧未在真机验证,不得宣称已验证。

Windows 验证边界

自动化测试要求在 windows-latest 上同时用 Windows PowerShell 5.1 和 PowerShell 7 验证确定性应用解析、Node.js 22 门禁、当前用户 Scheduled Task、入口语义、UTF-8 BOM、BAT CRLF,以及中文和空格路径。真实 Scheduled Task 集成测试只能使用 GUID 测试任务名,不得触碰生产任务。

Microsoft Store 真机待验证:自动化证据不证明真实 Store/MSIX 安装的 AUMID 激活、回环豁免后 HTTP CDP、或包内可执行文件回退能完成注入。已实现差分诊断与一次性 enable-loopback 引导,但在真机 netstat / /json/version 证据补齐前,不宣称该路径已完整验证。

© HeiGeAi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in skill/heige-codex-skin-studio of HeiGeAi/heige-codex-skin-studio.

  • SKILL.md
  • README.md
  • scripts/install.bat
  • scripts/install.command
  • scripts/install.ps1

Open the folder on GitHubat commit a6fa398

Compare with similar skills

Heige Codex Skin Studio next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Heige Codex Skin Studio compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Heige Codex Skin Studio this skillHeiGeAi/heige-codex-skin-studio478—~1.5kAutomated safety check: PassMIT
Desktop ElectronOpenHands/OpenHands90k—~302Automated safety check: PassMIT
AgentSquad for Swift2FastLabs/agent-squad7.8k—~3.5kAutomated safety check: PassApache-2.0
Perfupraullenchai/Rapid-MLX4k—~1.6kAutomated safety check: NotesCustom licence
Mlx Serveddalcu/mlx-serve1.8k—~1kAutomated safety check: PassCustom licence
Pulse Releasequnqin24/Pulse521—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Desktop Electron

    OpenHands/OpenHands

    This skill should be used when the user asks to "change the desktop app", "package Electron", "build a universal macOS app", "bundle Node or uv", "fix Electron startup", or changes electron/…

    90k GitHub stars~302 tokensUpdated today
    Auto-check passed
  • AgentSquad for Swift

    2FastLabs/agent-squad

    Guides building on-device multi-agent apps in Swift with the AgentSquad framework: which agent, orchestrator, classifier, storage or voice type fits each situation.

    7.8k GitHub stars~3.5k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Perfup

    raullenchai/Rapid-MLX

    Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

    4k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Mlx Serve

    ddalcu/mlx-serve

    Hook an app, game or script up to the local mlx-serve server for LLM chat, embeddings, image, speech, music, sound effect, video and 3D generation, and Laya/Kev/Clef typed decisions.

    1.8k GitHub stars~1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Pulse Release

    qunqin24/Pulse

    Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.

    521 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Persona Character Scenes

    miuuyy/persona-voice

    Generate, review, and integrate consistent 2D or stylized 3D character background scenes for Codex Persona Voice session cards.

    133 GitHub stars~953 tokensUpdated 18 days ago
    Media & CreativeAuto-check passed

Works with

Questions about Heige Codex Skin Studio

What does Heige Codex Skin Studio do?

A skill your agent uses when 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤。. Heige Codex Skin Studio is an agent skill from HeiGeAi/heige-codex-skin-studio.

When should I use Heige Codex Skin Studio?

Heige Codex Skin Studio fits situations like: 用户希望在 macOS 或 Windows 安装、制作、应用、暂停、恢复或设置 HeiGe Codex Desktop 皮肤常驻,或给腾讯 CodeBuddy 桌面端(WorkBuddy)一次性换肤.

How do I install Heige Codex Skin Studio in Claude Code?

Run `npx skills add HeiGeAi/heige-codex-skin-studio --skill heige-codex-skin-studio -a claude-code`. Or copy the skill folder (skill/heige-codex-skin-studio in HeiGeAi/heige-codex-skin-studio) into .claude/skills/heige-codex-skin-studio in your project. Claude Code loads it when a task matches its description.

How do I install Heige Codex Skin Studio in Codex?

Run `npx skills add HeiGeAi/heige-codex-skin-studio --skill heige-codex-skin-studio -a codex`. Or copy the skill folder (skill/heige-codex-skin-studio in HeiGeAi/heige-codex-skin-studio) into .agents/skills/heige-codex-skin-studio in your project. Codex loads it when a task matches its description.

Can I use Heige Codex Skin Studio in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HeiGeAi/heige-codex-skin-studio --skill heige-codex-skin-studio -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/heige-codex-skin-studio, .gemini/skills/heige-codex-skin-studio, .github/skills/heige-codex-skin-studio and .opencode/skills/heige-codex-skin-studio in your project.

What does Heige Codex Skin Studio need to run?

Going by SKILL.md and its folder, Heige Codex Skin Studio needs Windows cmd and PowerShell for the scripts in its folder. Our summary lists: Node.js; PowerShell.

Does Heige Codex Skin Studio access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Heige Codex Skin Studio safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Heige Codex Skin Studio use?

Heige Codex Skin Studio is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Heige Codex Skin Studio use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Heige Codex Skin Studio?

Skills that share tags, products or a category with Heige Codex Skin Studio: Desktop Electron (OpenHands/OpenHands, 90k stars), AgentSquad for Swift (2FastLabs/agent-squad, 7.8k stars), Perfup (raullenchai/Rapid-MLX, 4k stars) and Mlx Serve (ddalcu/mlx-serve, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Heige Codex Skin Studio?

HeiGeAi (a GitHub user) maintains it in HeiGeAi/heige-codex-skin-studio, which has 478 GitHub stars. The repository was last updated on October 8, 2026.

Source: HeiGeAi/heige-codex-skin-studio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.