Agent skill

Workbuddy Skin Studio

by cdredfox in cdredfox/workbuddy-skin-studio

Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection.

MITAuto-check passedMobile

Install Workbuddy Skin Studio

skills CLI
$ npx skills add cdredfox/workbuddy-skin-studio --skill workbuddy-skin-studio -a claude-code

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

GitHub CLI
$ gh skill install cdredfox/workbuddy-skin-studio workbuddy-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).

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

Facts

Skill name
workbuddy-skin-studio
GitHub stars
198
Token cost
~1.5k tokens
SKILL.md length
617 words
Files
56 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection.

  • Works in 3 steps: Clone / open the repo, then run the… → Verify → A 🎨 button appears at the top-right of…
  • The user wants to change WorkBuddys appearance/theme/skin
  • SKILL.md covers When this skill applies, Prerequisites, Platform detection (run first) and Workflow — macOS, plus 7 more sections
  • Runs PowerShell and JavaScript scripts from its folder; calls node

What it does

Workbuddy Skin Studio is an agent skill from cdredfox/workbuddy-skin-studio. Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection. Use when the user wants to change WorkBuddy's appearance/theme/skin, references an open-source WorkBuddy theming project by GitHub URL, or says phrases like "帮我换 WorkBuddy 主题/皮肤", "用这个开源项目帮我更换 WorkBuddy 的主题", or "change my WorkBuddy theme". Never modifies app.asar, the official install directory, or code signing.

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

It sits in Mobile, covering Theming and dark mode and App store release. It works with GitHub and macOS. The repository describes itself as: 给 Workbuddy Desktop 一键换肤:一张图片就是一个主题,右上角菜单即时切换 | Reskin Workbuddy Desktop on macOS via loopback CDP injection. The licence is MIT.

When your agent uses it

  • The user wants to change WorkBuddys appearance/theme/skin
  • References an open-source WorkBuddy theming project by GitHub URL
  • Says phrases like 帮我换 WorkBuddy 主题/皮肤
  • 用这个开源项目帮我更换 WorkBuddy 的主题

Example prompts

  • “帮我换 WorkBuddy 主题/皮肤”
  • “用这个开源项目帮我更换 WorkBuddy 的主题”
  • “change my WorkBuddy theme”
  • “/workbuddy-skin-studio”

Requirements

  • Node.js
  • PowerShell

Workflow steps

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

  1. Clone / open the repo, then run the launcher (double-click works, or CLI)
  2. Verify
  3. A 🎨 button appears at the top-right of WorkBuddy. Tell the user they can

What it can do on your machine

Read from SKILL.md and the folder at commit bedfadb. 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 7 files in scripts/ (PowerShell and JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    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

Workbuddy Skin Studio loads about 1.5k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 617 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
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 cdredfox/workbuddy-skin-studio at commit bedfadb, republished under its MIT licence (© cdredfox). 617 words, ~1,508 tokens.

Download SKILL.mdSave it as .claude/skills/workbuddy-skin-studio/SKILL.md (or your agent's skills folder). This skill also uses 55 other files; get the full folder from GitHub.
name
workbuddy-skin-studio
description
Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection. Use when the user wants to change WorkBuddy's appearance/theme/skin, references an open-source WorkBuddy theming project by GitHub URL, or says phrases like "帮我换 WorkBuddy 主题/皮肤", "用这个开源项目帮我更换 WorkBuddy 的主题", or "change my WorkBuddy theme". Never modifies app.asar, the official install directory, or code signing.

WorkBuddy Skin Studio

Reversible WorkBuddy desktop theming through local CDP injection. The tool restarts WorkBuddy with --remote-debugging-port=9223, discovers its renderer (renderer/index.html), and injects CSS + a 🎨 theme menu into the live UI. No official files are touched.

When this skill applies

  • The user gives you a GitHub URL for workbuddy-skin-studio (or similar) and asks you to install / apply / use it to theme WorkBuddy.
  • The user wants to change WorkBuddy's look (color theme, background image, custom uploaded image) without editing the official app.
  • The user reports the theme disappeared after a WorkBuddy restart and wants it reapplied, or wants to revert to the native look.

Prerequisites

  • WorkBuddy desktop installed (this tool themes the desktop app, not web).
  • Node.js 18+ on PATH (the injector is plain Node, cross-platform).
  • macOS or Windows. (Linux is not supported by WorkBuddy's desktop build.)
  • Warn the user once: applying restarts WorkBuddy and any unsaved in-app work is lost. Ask them to save first.

Platform detection (run first)

  • macOS: shell uname returns Darwin, or $OSTYPE starts with darwin.
  • Windows: PowerShell $IsWindows is $true, or $env:OS is Windows_NT.
  • Choose the matching branch below.

Workflow — macOS

  1. Clone / open the repo, then run the launcher (double-click works, or CLI):

    bash
    # default theme (miku-light)
    ./scripts/apply.command
    
    # or a specific theme via the cross-platform CLI
    node src/cli.mjs apply --theme genshin-night

    apply.command quits WorkBuddy, relaunches it with the CDP port, waits for the debugger, and injects the skin.

  2. Verify:

    bash
    node src/cli.mjs status

    Expect an injected/active state and the WorkBuddy renderer listed.

  3. A 🎨 button appears at the top-right of WorkBuddy. Tell the user they can switch themes, upload a custom image, or revert to native from that menu.

Workflow — Windows

  1. From the repo directory, run in PowerShell (not cmd):

    powershell
    # default theme (miku-light)
    .\scripts\apply.ps1
    
    # or a specific theme
    .\scripts\apply.ps1 -Theme genshin-night

    If you hit an execution-policy error, run once: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, then retry.

  2. If apply.ps1 cannot locate WorkBuddy.exe, run the locator and follow its printed hint (often you just need to launch WorkBuddy once so the path is registered):

    powershell
    .\scripts\find-workbuddy.ps1
  3. Verify:

    powershell
    node src/cli.mjs status
  4. Same 🎨 menu appears top-right in WorkBuddy.

Choosing a theme

  • List available themes: node src/cli.mjs list (macOS) / same via PowerShell.
  • Built-ins include miku-light, miku-488137, genshin-dawn, genshin-night, deepspace-dawn, deepspace-star, naruto-hokage, naruto-sasuke, wuthering-echo, wuthering-tide.
  • If the user names a mood/character (e.g. "dark Genshin"), map it to the closest id, or just apply the default and let them pick from the 🎨 menu.
  • Custom image: node src/cli.mjs create --image "/path/to/hero.webp" --name "My Skin" then node src/cli.mjs apply --theme my-skin. The in-app 🎨 menu also supports "+ 自定义图片" with automatic color extraction.
Show full SKILL.md (224 more words)Show less

Pause / restore to native

bash
# macOS
./scripts/pause.command

# Windows (PowerShell)
.\scripts\pause.ps1

This removes the injected skin and relaunches WorkBuddy normally. The official install is always left untouched.

Guardrails

  • Never replace, edit, or take ownership of WorkBuddy.app, app.asar, or the Windows install directory. This tool only injects into the live renderer.
  • CDP binds to loopback 127.0.0.1 only. Tell the user not to run untrusted local software while a skin is active (Chromium CDP has no same-user auth).
  • Injection lives for the renderer's lifetime. After a manual WorkBuddy restart the skin disappears by design — re-run apply to bring it back.
  • Do not import README/preview screenshots or images with baked-in UI as a theme background; use clean wallpapers / character art.

Checks (sanity before reporting done)

bash
node src/cli.mjs doctor   # platform, app path, CDP port, renderer hint
node src/cli.mjs status   # injection state
node --check src/cli.mjs  # syntax

doctor should report the correct platform, a found WorkBuddy app, and the renderer hint renderer/index.html.

Resources

  • src/cli.mjs — entry point: list / create / apply / status / pause / doctor.
  • src/cdp-client.mjs — CDP connection + renderer discovery.
  • src/skin-css.mjs — --cb-* variable overrides + background + container transparency.
  • src/skin-menu.mjs — the 🎨 in-app menu (switch / upload / delete / native).
  • src/injector.mjs — idempotent CSS+menu injection and removal.
  • src/constants.mjs, src/theme-schema.mjs, src/theme-store.mjs — config & theme model.
  • scripts/apply.command / pause.command — macOS launchers.
  • scripts/apply.ps1 / pause.ps1 / find-workbuddy.ps1 — Windows launchers.
  • themes/ — 10 built-in theme folders (theme.json + hero.webp).
  • README.md — full human-readable documentation.

One-line summary for the user

"I cloned workbuddy-skin-studio, restarted WorkBuddy in debug mode, and injected the theme. Use the 🎨 button (top-right) to switch or revert. Re-run apply if you restart WorkBuddy manually."

© cdredfox, 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 55 other files (scripts) in the repository root of cdredfox/workbuddy-skin-studio.

  • SKILL.md
  • .DS_Store
  • .gitignore
  • LICENSE
  • README.md
  • docs/images/preview-dark.png
  • docs/images/preview-main.png
  • docs/images/preview-menu.png
  • package.json
  • scripts/apply.command
  • scripts/apply.ps1
  • scripts/find-workbuddy.ps1
  • scripts/generate-hero.mjs
  • scripts/pause.command
  • scripts/pause.ps1
  • scripts/png-to-webp.mjs
  • src/cdp-client.mjs
  • … and 39 more

Open the folder on GitHubat commit bedfadb

Compare with similar skills

Workbuddy 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.

Workbuddy Skin Studio compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workbuddy Skin Studio this skillcdredfox/workbuddy-skin-studio198—~1.5kAutomated safety check: PassMIT
Releasenotepadqq/notepadqq2.3k—~2kAutomated safety check: PassGPL-3.0
Releasenikships/droidproxy122—~1.1kAutomated safety check: PassMIT
Electron Builderpedronauck/skills634—~2.7kAutomated safety check: PassNone
Releasing macOS Appsjamesrochabrun/skills216—~2.4kAutomated safety check: PassMIT
Ship Infiniten1m21n/Infinite268—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • Release

    notepadqq/notepadqq

    Release a new Notepadqq version. An agent skill from notepadqq/notepadqq.

    2.3k GitHub stars~2k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Release

    nikships/droidproxy

    Build, sign, notarize, and publish a new DroidProxy release.

    122 GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed
  • Electron Builder

    pedronauck/skills

    Comprehensive guide for electron-builder (v26.x) packaging, code signing, auto-updates, and release workflows.

    634 GitHub stars~2.7k tokensUpdated 24 days ago
    MobileAuto-check passed
  • Releasing macOS Apps

    jamesrochabrun/skills

    Create notarized macOS app releases with Sparkle auto-updates, DMG installers, and GitHub releases.

    216 GitHub stars~2.4k tokensUpdated 8 mo ago
    MobileAuto-check passed
  • Ship Infinite

    n1m21n/Infinite

    Full release: verify, commit, push, tag with curated notes, build the macOS DMG, pull CI Windows zips and Linux AppImage, publish to the Release and GitHub Pages site, flag Node Reference Manual…

    268 GitHub stars~4.1k tokensUpdated today
    MobileAuto-check passed
  • Release App

    yannikzz/narracat-novel-agent

    Cut and publish a new NarraCat-app version — bump the version number, build the Windows x64 package in CI, package + sign + notarize the macOS build locally, and publish both platforms into one…

    103 GitHub stars~1.6k tokensUpdated 2 days ago
    Testing & QAAuto-check: notes

Works with

Questions about Workbuddy Skin Studio

What does Workbuddy Skin Studio do?

Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection. Workbuddy Skin Studio is an agent skill from cdredfox/workbuddy-skin-studio. Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection.

When should I use Workbuddy Skin Studio?

Workbuddy Skin Studio fits situations like: the user wants to change WorkBuddys appearance/theme/skin; references an open-source WorkBuddy theming project by GitHub URL; says phrases like 帮我换 WorkBuddy 主题/皮肤; 用这个开源项目帮我更换 WorkBuddy 的主题.

How do I install Workbuddy Skin Studio in Claude Code?

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

How do I install Workbuddy Skin Studio in Codex?

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

Can I use Workbuddy 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 cdredfox/workbuddy-skin-studio --skill workbuddy-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/workbuddy-skin-studio, .gemini/skills/workbuddy-skin-studio, .github/skills/workbuddy-skin-studio and .opencode/skills/workbuddy-skin-studio in your project.

What does Workbuddy Skin Studio need to run?

Going by SKILL.md and its folder, Workbuddy Skin Studio needs PowerShell and JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js; PowerShell.

Does Workbuddy 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 Workbuddy 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 Workbuddy Skin Studio use?

Workbuddy Skin Studio is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workbuddy Skin Studio use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Workbuddy Skin Studio?

Skills that share tags, products or a category with Workbuddy Skin Studio: Release (notepadqq/notepadqq, 2.3k stars), Release (nikships/droidproxy, 122 stars), Electron Builder (pedronauck/skills, 634 stars) and Releasing macOS Apps (jamesrochabrun/skills, 216 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workbuddy Skin Studio?

cdredfox (a GitHub user) maintains it in cdredfox/workbuddy-skin-studio, which has 198 GitHub stars. The repository was last updated on July 17, 2026.

Source: cdredfox/workbuddy-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.