Codedrobe adapter dev
Agent Skills for theming AI desktop apps: reference image → reversible Codex/WorkBuddy skin → verify, repair, publish. | 给 AI 桌面应用换肤的 Agent Skills:参考图 → 可逆皮肤 → 验证、修复、发布。
npx -y skills add CodeDrobe/skills --skill codedrobe-adapter-devAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 21 days oldThe repository was created 21 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
What its author says it does
Copied from the file, not written here
Add, inspect, repair, or validate CodeDrobe Core adapters for Chromium/Electron AI desktop applications. Use when supporting a new app, updating Codex or WorkBuddy compatibility after an app release, discovering installation paths or CDP targets, selecting stable DOM landmarks, adding renderer profiles or transactional host settings, recording lastVerified versions, or writing adapter and real-renderer tests.
SKILL.md
3.8 KB, as published. Nobody here has run it
CodeDrobe Adapter Development
Work in the @codedrobe/core repository. Keep the adapter lightweight and prove selectors against a real installed application; never infer renderer compatibility from an app name, executable path, or screenshot alone.
Read the relevant references
- Read references/architecture.md before changing ownership between Core, adapters, renderer profiles, themes, Skills, or Desktop.
- Read references/adapter-contract.md before editing adapter code, exports, host settings, or types.
- Read references/dom-inspection.md before collecting CDP targets or choosing selectors.
- Read references/testing.md before claiming support or updating
lastVerified.
Add or repair an adapter
- Inspect the current Core tree, adapter registry, tests, CLI help, and working-tree changes.
- Locate the actual installed app and record its app version/build. Do not overwrite unrelated local changes.
- Launch the real app with loopback CDP on a configurable, unoccupied port. Do not restart or terminate it without authorization.
- Inspect
/json/list, select the actual renderer, and runcodedrobe dom snapshoton every relevant route to collect privacy-preserving semantic DOM evidence. - Choose only cross-route landmarks for the adapter: root, sidebar/navigation, workspace/content, and composer/input. Only
rootAnyshould block (it doubles as the boot detector); declare panels the app can hide — sidebars in popped-out or collapsed windows — asrecommended, since compatibility is judged per window. - Put app- or theme-specific layout nodes in theme verification contexts, not the adapter.
- Implement the adapter, registry export, types, and focused tests. Add a renderer profile or host-settings module only when the application requires that behavior.
- Probe the real renderer, then apply and verify a minimal package. Validate the home and conversation contexts separately.
- Restore the renderer and any transactional host settings. Confirm cleanup before finishing.
- Update
lastVerifiedonly after real-app verification succeeds, including the observed version/build and date.
Compatibility failure workflow
- Reproduce with
codedrobe probe --app <id> --theme <package>. - Separate adapter landmark failures from theme-specific missing nodes.
- Inspect the live DOM and computed layout; do not repair from stale documentation alone.
- Prefer a stable alternative selector before broadening
anylists. - Keep failure output concrete: requirement name plus every attempted selector.
- Add a regression test before updating
lastVerified.
Guardrails
- Never patch application bundles,
app.asar, code signatures, WindowsApps ownership, or user authentication data. - Bind CDP to
127.0.0.1and reject occupied custom ports instead of killing unknown processes. - Avoid generated CSS-module hashes, localized text, deep child chains, and broad selectors such as
body *in adapters. - Keep optional decoration out of adapter requirements.
- Preserve custom installation paths and user-selected CDP ports throughout detect, launch, probe, apply, verify, watch, and restore.
- Do not add a public theme-publishing path until registry authentication and authorization are complete.