CodeDrobe Skills

Installable Agent Skills for creating and managing reversible themes across supported Chromium/Electron AI desktop apps. Runtime behavior lives in @codedrobe/core; this repository contains concise workflows and app-specific guidance only.

简体中文

Skill catalog

Skill	Audience	Status
codedrobe-theme	Users and theme authors	Available
codedrobe-adapter-dev	Core maintainers and contributors	Available
codedrobe-publish-theme	Theme publishers	Planned after registry authentication is complete

codedrobe-theme supports the application targets currently provided by Core, including OpenAI Codex and Tencent WorkBuddy. New apps are added to Core adapters rather than creating one user Skill per application.

Install

The installer command is npx skills (plural).

List the Skills in this repository:

npx skills add CodeDrobe/skills --list

Install the user-facing theme Skill globally for Codex:

npx skills add CodeDrobe/skills \
  --skill codedrobe-theme \
  --global \
  --agent codex \
  --yes

Install the adapter-development Skill separately:

npx skills add CodeDrobe/skills \
  --skill codedrobe-adapter-dev \
  --global \
  --agent codex \
  --yes

--agent codex selects the AI agent that receives the Skill. It does not select the desktop app to theme. The target app is selected later through codedrobe --app codex or codedrobe --app workbuddy.

Runtime

Install Core once:

npm install --global @codedrobe/core
codedrobe apps

Or run it without a global install:

npx --yes @codedrobe/core@latest apps
bunx @codedrobe/core@latest apps

Example:

codedrobe dom snapshot --app workbuddy --output /absolute/workbuddy-dom.json
codedrobe apply --app workbuddy --theme /absolute/theme.codedrobe-theme
codedrobe verify --app workbuddy --theme /absolute/theme.codedrobe-theme --screenshot /absolute/preview.png
codedrobe restore --app workbuddy

Theme authoring resources

The installed codedrobe-theme Skill includes two copyable source resources:

• assets/theme-starter/: a complete neutral Codex/WorkBuddy CSS starting point.
• assets/examples/doll-sister/: the complete Doll Sister / 玩偶姐姐 multi-app theme with generated hero and texture artwork.

Templates are not treated as permanent application DOM contracts. The Skill captures a privacy-preserving codedrobe dom snapshot from each live home/conversation context, selects semantic candidates from that snapshot, then packs, probes, applies, screenshots, and repairs the theme.

Repository layout

skills/
├── codedrobe-theme/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   ├── references/
│   └── assets/
└── codedrobe-adapter-dev/
    ├── SKILL.md
    ├── agents/openai.yaml
    └── references/

There is intentionally no root SKILL.md: the standard skills/<name>/SKILL.md layout allows npx skills to discover and install each Skill independently.

Project boundaries

• CodeDrobe/core: CLI, adapters, CDP runtime, host settings, package validation, and public API.
• CodeDrobe/skills: installable agent workflows and references.
• CodeDrobe/desktop: visual theme manager built on Core.
• Theme publishing: intentionally withheld until authentication, ownership, moderation, and revocation are implemented.

See CONTRIBUTING.md before adding or changing a Skill.

License and trademarks

Instructions and documentation are available under the Apache License 2.0. Product names and trademarks belong to their respective owners. CodeDrobe is an independent project and is not endorsed by OpenAI or Tencent.