Agent Skills › Fei-Away/Codex-Dream-Skin › codex-dream-skin-studio

codex-dream-skin-studio

GitHub

用于在macOS上安装、自定义、验证和修复Codex Dream Skin Studio，将个人图片转化为连续全屏壁纸并保留原生界面。提供安全的CDP主题调试与回滚功能，确保不修改官方应用签名且保持原生交互体验。

macos/SKILL.md Fei-Away/Codex-Dream-Skin

触发场景

用户希望将个人图片设置为Codex应用的连续全屏壁纸需要调整Codex应用的视觉主题或背景样式 Codex应用出现主题显示异常或布局错乱需要修复需要将Codex应用恢复至官方默认外观涉及Codex CDP连接的故障排查与安全验证

安装

npx skills add Fei-Away/Codex-Dream-Skin --skill codex-dream-skin-studio -g -y

更多选项

非标准路径

npx skills add https://github.com/Fei-Away/Codex-Dream-Skin/tree/main/macos -g -y

不安装直接使用

npx skills use Fei-Away/Codex-Dream-Skin@codex-dream-skin-studio

指定 Agent (Claude Code)

npx skills add Fei-Away/Codex-Dream-Skin --skill codex-dream-skin-studio -a claude-code -g -y

安装 repo 全部 skill

npx skills add Fei-Away/Codex-Dream-Skin --all -g -y

预览 repo 内 skill

npx skills add Fei-Away/Codex-Dream-Skin --list

SKILL.md

Frontmatter

{
    "name": "codex-dream-skin-studio",
    "description": "Install, customize, launch, verify, repair, update, or restore Codex Dream Skin Studio on macOS. Use when a user wants to turn a personal image into one continuous full-window Codex wallpaper with adaptive readability layers while preserving the native interface, or needs safe CDP theme troubleshooting and rollback.",
    "compatibility": "macOS, official Codex Desktop app, signed bundled Node.js 20 or newer"
}

Codex Dream Skin Studio

This file is an optional Codex capability entry. The delivery is a complete standalone project; users do not need to install it as a Skill.

Workflow

Run Install Codex Dream Skin.command from the complete project folder.
Run Customize Codex Dream Skin.command, choose an image in Finder, and enter a theme name.
Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal overflow, non-interactive decoration, and—on the home route—a continuous wallpaper with live native heading, project controls, and any suggestion cards exposed by the current Codex version.
Restore the official appearance with Restore Codex Dream Skin.command.

Guardrails

Never modify the official .app, app.asar, or its code signature.
Use the official Codex app's signed Node.js runtime only after validating its signature, Team ID, architecture, and minimum version.
Bind CDP to loopback, verify that the listener belongs to Codex, and reject non-Codex renderer targets.
Preserve all native cards, navigation, project selectors, task content, composer controls, and keyboard focus.
Theme images must be UI-free wallpapers. Paint one 16:9 image continuously across the window; keep home expressive and task routes quieter. appearance: auto follows Codex/native or system appearance rather than image brightness.
Keep decoration at pointer-events: none.
Require explicit authorization before restarting an already-running Codex instance.
Stop an injector only when its recorded PID, executable, command line, and start time all match.

Key resources

README.md: user installation and customization guide.
scripts/injector.mjs: CDP connection, injection, removal, verification, and screenshots.
assets/dream-skin.css: live native interface styling.
assets/renderer-inject.js: idempotent DOM integration and cleanup.
scripts/doctor-macos.sh: signed-runtime, payload, and optional live-session self-check.
references/qa-inventory.md: release and visual acceptance criteria.