Not in the top 1,000 by GitHub stars
comeonzhj/WorkBuddy-theme-skill
Create, validate, preview, switch, and safely apply runtime themes for the WorkBuddy Electron desktop app.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
workbuddy-theme/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
4e7dd6e079e8 → 4e7dd6e079e8
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 4e7dd6e079e8
No earlier version was observed for comparison.
Heat
0.3- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- workbuddy-theme
workbuddy-theme
How it works
workbuddy-theme
When your agent uses it
Create, inspect, validate, preview, package, publish, apply, and restore reversible CSS skins for the WorkBuddy Electron desktop app on macOS and Windows. Use when a user asks to reskin WorkBuddy, adapt a visual reference or Figma CSS into a WorkBuddy theme, prepare a Theme Manager ZIP, contribute a theme to the GitHub community registry, diagnose compatibility after a WorkBuddy update, or safely inject and remove a runtime theme without modifying app.asar or the signed application bundle.
What it loads into context
Frontmatter
108 tokensAlways available to the agent
SKILL.md
2,010 tokensWhen the skill is activated
Reference documents
4,565 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Read the operating contract
- Choose the workflow
- Write the design contract before CSS
- Build a theme
- WorkBuddy 5.2.6 implementation lessons
- Validate before application
- Permission gate for application
- Switch installed themes
- Package or publish a theme
- Real-app acceptance
Scripts executed separately
scripts/build-registry.mjsscripts/switch-theme.mjsscripts/validate-theme.mjsscripts/workbuddy-theme.mjs
Files
SKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesSKILL.mdcore9,933 bytesagents/openai.yamlasset269 bytesassets/a-ke/DESIGN-CONTRACT.mddoc767 bytesassets/a-ke/background.webpasset1,176,966 bytesassets/a-ke/preview.htmlasset5,604 bytesassets/a-ke/preview.pngasset1,040,903 bytesassets/a-ke/theme-art.webpasset160,828 bytesassets/a-ke/theme.cssasset12,886 bytesassets/a-ke/theme.jsonasset1,568 bytesassets/ai-product-conference-2026/conference-bg.pngasset1,919,435 bytesassets/ai-product-conference-2026/preview.htmlasset5,110 bytesassets/ai-product-conference-2026/preview.pngasset866,943 bytesassets/ai-product-conference-2026/theme.cssasset11,388 bytesassets/ai-product-conference-2026/theme.jsonasset1,675 bytesassets/angle/DESIGN-CONTRACT.mddoc743 bytesassets/angle/background.webpasset832,718 bytesassets/angle/preview.htmlasset5,612 bytesassets/angle/preview.pngasset1,022,854 bytesassets/angle/theme-art.webpasset137,168 bytesassets/angle/theme.cssasset12,938 bytesassets/angle/theme.jsonasset1,571 bytesassets/fushu/DESIGN-CONTRACT.mddoc755 bytesassets/fushu/background.pngasset1,723,252 bytesassets/fushu/preview.htmlasset5,608 bytesassets/fushu/preview.pngasset803,098 bytesassets/fushu/theme-art.webpasset39,146 bytesassets/fushu/theme.cssasset12,966 bytesassets/fushu/theme.jsonasset1,565 bytesassets/honor-of-kings/DESIGN-CONTRACT.mddoc767 bytesassets/honor-of-kings/IMAGEGEN-PROMPT.mddoc2,014 bytesassets/honor-of-kings/honor-of-kings-bg.pngasset2,221,398 bytesassets/honor-of-kings/preview.htmlasset5,574 bytesassets/honor-of-kings/preview.pngasset1,084,569 bytesassets/honor-of-kings/theme.cssasset13,364 bytesassets/honor-of-kings/theme.jsonasset1,522 bytesassets/wukong/DESIGN-CONTRACT.mddoc737 bytesassets/wukong/background.webpasset1,249,906 bytesassets/wukong/preview.htmlasset5,621 bytesassets/wukong/preview.pngasset1,034,834 bytesassets/wukong/theme-art.webpasset121,554 bytesassets/wukong/theme.cssasset13,010 bytesassets/wukong/theme.jsonasset1,596 bytesassets/xiaoqiao/DESIGN-CONTRACT.mddoc938 bytesassets/xiaoqiao/background.webpasset905,962 bytesassets/xiaoqiao/preview.htmlasset5,635 bytesassets/xiaoqiao/preview.pngasset1,012,279 bytesassets/xiaoqiao/theme-art.webpasset137,250 bytesassets/xiaoqiao/theme.cssasset13,181 bytesassets/xiaoqiao/theme.jsonasset1,599 bytesassets/yao/DESIGN-CONTRACT.mddoc719 bytesassets/yao/background.webpasset465,584 bytesassets/yao/preview.htmlasset5,597 bytesassets/yao/preview.pngasset981,060 bytesassets/yao/theme-art.webpasset104,452 bytesassets/yao/theme.cssasset12,873 bytesassets/yao/theme.jsonasset1,564 bytesreferences/community-publishing.mddoc2,471 bytesreferences/workbuddy-contract.mddoc7,201 bytesregistry.jsonasset12,238 bytesscripts/build-registry.mjsruns4,181 bytesscripts/switch-theme.mjsruns3,443 bytesscripts/validate-theme.mjsruns4,010 bytesscripts/workbuddy-theme.mjsruns19,951 bytes
Read SKILL.md
# Theme WorkBuddy safely
Create runtime-only themes for WorkBuddy. Never modify `/Applications/WorkBuddy.app`, `app.asar`, its integrity metadata, its code signature, authentication data, or user conversations.
## Read the operating contract
Read [references/workbuddy-contract.md](references/workbuddy-contract.md) before inspecting the application, creating CSS, applying a theme, or validating a new WorkBuddy version. It contains the verified app structure, design contract, selectors, safety boundary, and QA matrix.
## Choose the workflow
- For a new visual reference, inspect it, write a design contract, then start from `assets/ai-pm-course/` or create a sibling theme folder.
- For compatibility work, run `node scripts/workbuddy-theme.mjs inspect`, then `node scripts/workbuddy-theme.mjs probe` on an authorized themed session, and compare the reported version, renderer URL, stable roots, tokens, geometry, and overflow with the reference contract.
- For validation, run `node scripts/validate-theme.mjs /absolute/theme-directory`.
- For preview, open the theme's `preview.html`; label it as a design preview, never a verified WorkBuddy screenshot.View the complete source on GitHubSkills included
- workbuddy-theme
Repository facts
- License
- MIT
- Created
- Jul 18, 2026
- Last pushed
- Jul 18, 2026
- Forks
- 6
- Open issues
- 2
- Project activity
- Slowing
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 6, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 6 notes
workbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedworkbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedworkbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedworkbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedworkbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedworkbuddy-theme/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 11 network referencesin 4 files: workbuddy-theme/registry.json:6 workbuddy-theme/scripts/build-registry.mjs:72 workbuddy-theme/scripts/switch-theme.mjs:35 and 1 more
- No hidden or obfuscated text
- No instruction overrides
- 4 executable scriptsin 4 files: workbuddy-theme/scripts/build-registry.mjs:1 workbuddy-theme/scripts/switch-theme.mjs:1 workbuddy-theme/scripts/validate-theme.mjs:1 and 1 more
- No access to secrets
- No requests to vote in Hot
Show all 15 signals by file
workbuddy-theme/registry.json
- Network accessline 6
"name": "WorkBuddy-theme-skill", "branch": "main", "rawBaseUrl": "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/" - Network accessline 7
"branch": "main", "rawBaseUrl": "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/" }, - Network accessline 8
"rawBaseUrl": "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/"
workbuddy-theme/scripts/build-registry.mjs
- Executable scriptline 1
#!/usr/bin/env node - Network accessline 72
name: "WorkBuddy-theme-skill", branch: "main", rawBaseUrl: "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/" - Network accessline 73
branch: "main", rawBaseUrl: "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/" }, - Network accessline 74
rawBaseUrl: "https://raw.githubusercontent.com/comeonzhj/WorkBuddy-theme-skill/main/"
workbuddy-theme/scripts/switch-theme.mjs
- Executable scriptline 1
#!/usr/bin/env node - Network accessline 35
async function endpointIsLive() { try { const response = await fetch("http://127.0.0.1:9339/json/list", { signal: AbortSignal.timeout(900) }); - Network accessline 36
try { const response = await fetch("http://127.0.0.1:9339/json/list", { signal: AbortSignal.timeout(900) }); return response.ok; - Network accessline 37
const response = await fetch("http://127.0.0.1:9339/json/list", { signal: AbortSignal.timeout(900) });
workbuddy-theme/scripts/validate-theme.mjs
- Executable scriptline 1
#!/usr/bin/env node
workbuddy-theme/scripts/workbuddy-theme.mjs
- Executable scriptline 1
#!/usr/bin/env node - Network accessline 82
async function targets(port) { const response = await fetch(`http://127.0.0.1:${port}/json/list`, { signal: AbortSignal.timeout(1000) }); - Network accessline 83
const response = await fetch(`http://127.0.0.1:${port}/json/list`, { signal: AbortSignal.timeout(1000) });
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Declared and executed: 1 fact
- Contacts raw.githubusercontent.com, which SKILL.md, the README and the plugin manifest do not mentionworkbuddy-theme/scripts/build-registry.mjs:74High confidence
Signal confidence: 12 facts
- Executable script in code of a file that runsworkbuddy-theme/scripts/build-registry.mjs:1High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/build-registry.mjs:72High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/build-registry.mjs:73High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/build-registry.mjs:74High confidence
- Executable script in code of a file that runsworkbuddy-theme/scripts/switch-theme.mjs:1High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/switch-theme.mjs:35High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/switch-theme.mjs:36High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/switch-theme.mjs:37High confidence
- Executable script in code of a file that runsworkbuddy-theme/scripts/validate-theme.mjs:1High confidence
- Executable script in code of a file that runsworkbuddy-theme/scripts/workbuddy-theme.mjs:1High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/workbuddy-theme.mjs:82High confidence
- Network access in code of a file that runsworkbuddy-theme/scripts/workbuddy-theme.mjs:83High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md workbuddy-theme/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.