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

Compare on GitHub

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.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 4e7dd6e079e8d2169d5bc409f59a4edacb44ffeb

21GitHub stars
0stars in 7 days
1skill in this repository
0commits in 30 days

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

Oct 25, 2026Oct 25, 202621

30-day change not yet available: not enough history.

Individual skills in this repository

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 tokens

Always available to the agent

SKILL.md

2,010 tokens

When the skill is activated

Reference documents

4,565 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Read the operating contract
  2. Choose the workflow
  3. Write the design contract before CSS
  4. Build a theme
  5. WorkBuddy 5.2.6 implementation lessons
  6. Validate before application
  7. Permission gate for application
  8. Switch installed themes
  9. Package or publish a theme
  10. Real-app acceptance

Scripts executed separately

  • scripts/build-registry.mjs
  • scripts/switch-theme.mjs
  • scripts/validate-theme.mjs
  • scripts/workbuddy-theme.mjs

Files

  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • SKILL.mdcore9,933 bytes
  • agents/openai.yamlasset269 bytes
  • assets/a-ke/DESIGN-CONTRACT.mddoc767 bytes
  • assets/a-ke/background.webpasset1,176,966 bytes
  • assets/a-ke/preview.htmlasset5,604 bytes
  • assets/a-ke/preview.pngasset1,040,903 bytes
  • assets/a-ke/theme-art.webpasset160,828 bytes
  • assets/a-ke/theme.cssasset12,886 bytes
  • assets/a-ke/theme.jsonasset1,568 bytes
  • assets/ai-product-conference-2026/conference-bg.pngasset1,919,435 bytes
  • assets/ai-product-conference-2026/preview.htmlasset5,110 bytes
  • assets/ai-product-conference-2026/preview.pngasset866,943 bytes
  • assets/ai-product-conference-2026/theme.cssasset11,388 bytes
  • assets/ai-product-conference-2026/theme.jsonasset1,675 bytes
  • assets/angle/DESIGN-CONTRACT.mddoc743 bytes
  • assets/angle/background.webpasset832,718 bytes
  • assets/angle/preview.htmlasset5,612 bytes
  • assets/angle/preview.pngasset1,022,854 bytes
  • assets/angle/theme-art.webpasset137,168 bytes
  • assets/angle/theme.cssasset12,938 bytes
  • assets/angle/theme.jsonasset1,571 bytes
  • assets/fushu/DESIGN-CONTRACT.mddoc755 bytes
  • assets/fushu/background.pngasset1,723,252 bytes
  • assets/fushu/preview.htmlasset5,608 bytes
  • assets/fushu/preview.pngasset803,098 bytes
  • assets/fushu/theme-art.webpasset39,146 bytes
  • assets/fushu/theme.cssasset12,966 bytes
  • assets/fushu/theme.jsonasset1,565 bytes
  • assets/honor-of-kings/DESIGN-CONTRACT.mddoc767 bytes
  • assets/honor-of-kings/IMAGEGEN-PROMPT.mddoc2,014 bytes
  • assets/honor-of-kings/honor-of-kings-bg.pngasset2,221,398 bytes
  • assets/honor-of-kings/preview.htmlasset5,574 bytes
  • assets/honor-of-kings/preview.pngasset1,084,569 bytes
  • assets/honor-of-kings/theme.cssasset13,364 bytes
  • assets/honor-of-kings/theme.jsonasset1,522 bytes
  • assets/wukong/DESIGN-CONTRACT.mddoc737 bytes
  • assets/wukong/background.webpasset1,249,906 bytes
  • assets/wukong/preview.htmlasset5,621 bytes
  • assets/wukong/preview.pngasset1,034,834 bytes
  • assets/wukong/theme-art.webpasset121,554 bytes
  • assets/wukong/theme.cssasset13,010 bytes
  • assets/wukong/theme.jsonasset1,596 bytes
  • assets/xiaoqiao/DESIGN-CONTRACT.mddoc938 bytes
  • assets/xiaoqiao/background.webpasset905,962 bytes
  • assets/xiaoqiao/preview.htmlasset5,635 bytes
  • assets/xiaoqiao/preview.pngasset1,012,279 bytes
  • assets/xiaoqiao/theme-art.webpasset137,250 bytes
  • assets/xiaoqiao/theme.cssasset13,181 bytes
  • assets/xiaoqiao/theme.jsonasset1,599 bytes
  • assets/yao/DESIGN-CONTRACT.mddoc719 bytes
  • assets/yao/background.webpasset465,584 bytes
  • assets/yao/preview.htmlasset5,597 bytes
  • assets/yao/preview.pngasset981,060 bytes
  • assets/yao/theme-art.webpasset104,452 bytes
  • assets/yao/theme.cssasset12,873 bytes
  • assets/yao/theme.jsonasset1,564 bytes
  • references/community-publishing.mddoc2,471 bytes
  • references/workbuddy-contract.mddoc7,201 bytes
  • registry.jsonasset12,238 bytes
  • scripts/build-registry.mjsruns4,181 bytes
  • scripts/switch-theme.mjsruns3,443 bytes
  • scripts/validate-theme.mjsruns4,010 bytes
  • scripts/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 GitHub

Skills 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 shell

Automated 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:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • workbuddy-theme/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • workbuddy-theme/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • workbuddy-theme/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • workbuddy-theme/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • workbuddy-theme/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
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
Signal confidence: 12 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md workbuddy-theme/SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md workbuddy-theme/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md workbuddy-theme/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md workbuddy-theme/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md workbuddy-theme/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard 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.