# Workbuddy Dream Skin

> Install, start, customize, verify, diagnose, or restore the external WorkBuddy Windows desktop theme in this directory.

- Skill: `zhouwei713/workbuddy-dream-skin` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add zhouwei713/workbuddy-dream-skin`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhouwei713/workbuddy-dream-skin/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhouwei713 (https://skillmd.com/u/zhouwei713)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhouwei713/workbuddy-dream-skin

---


# WorkBuddy Dream Skin

> **This file is a Codex/agent SKILL card** — an entry-point manifest used by Codex-style agents to know what this repo offers and which script to reach for. It is **not** a general user guide.
>
> **Human users:** please read [`README.md`](./README.md) and [`CONTRIBUTING.md`](./CONTRIBUTING.md).
> **AI collaborators editing this repo:** please read [`AGENTS.md`](./AGENTS.md).

Use the scripts in `scripts/` for all operations. Preserve the external injection boundary. Never edit the WorkBuddy installation, `app.asar`, executables, or signatures.

## Workflow

1. Read `README.md` and confirm Windows, Node.js 22, and WorkBuddy are available.
2. For first launch, warn that WorkBuddy will restart, then run `scripts/start-workbuddy-skin.ps1 -RestartExisting`.
3. Run `scripts/verify-workbuddy-skin.ps1` after every start or theme change.
4. Use `scripts/customize-workbuddy-theme.ps1` for image, layered artwork, composition, palette and decoration changes. Imported images use automatic style analysis by default; pass `-Style` for a deliberate palette, `-DecorationMode` for ornament behavior, or `-AnalyzeOnly` to preview the result.
5. Use `scripts/manage-workbuddy-themes.ps1` to list or apply saved presets.
6. If verification fails, inspect `%LOCALAPPDATA%\WorkBuddyDreamSkin\injector-error.log` and run `scripts/probe-workbuddy.ps1`.
7. Use `scripts/restore-workbuddy-skin.ps1 -RestartNormally` to return to an ordinary WorkBuddy launch.

Prefer hot reapplication when the verified CDP endpoint already exists. Restart WorkBuddy only when the first CDP enabled launch is required or the user requests it.