Agent Skills › sdbds/Codex-QingLong-Skin › codex-dream-skin-studio

codex-dream-skin-studio

GitHub

提供Codex Dream Skin Studio在macOS上的安装、定制、验证及修复功能，支持个性化皮肤应用与安全主题回滚。

macos/SKILL.md sdbds/Codex-QingLong-Skin

Trigger Scenarios

用户希望将个人图片设置为Codex横幅或任务背景需要排查或恢复Codex CDP主题问题

Install

npx skills add sdbds/Codex-QingLong-Skin --skill codex-dream-skin-studio -g -y

More Options

Non-standard path

npx skills add https://github.com/sdbds/Codex-QingLong-Skin/tree/main/macos -g -y

Use without installing

npx skills use sdbds/Codex-QingLong-Skin@codex-dream-skin-studio

指定 Agent (Claude Code)

npx skills add sdbds/Codex-QingLong-Skin --skill codex-dream-skin-studio -a claude-code -g -y

安装 repo 全部 skill

npx skills add sdbds/Codex-QingLong-Skin --all -g -y

预览 repo 内 skill

npx skills add sdbds/Codex-QingLong-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 a Codex banner and task background 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 real banner, native cards, and project selector.
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.
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.