Skip to content

beifeng724/personal-workbench-skills / skills/personal-workbench-builder

personal-workbench-builder

Verified

Build a durable personal or professional workbench as a runnable application, or produce a six-stage generic prompt pack for building it. Use when the user wants to turn a recurring workflow into a dashboard, management system, workspace, personal operating system, or long-lived website with multiple connected modules and persistent state. Trigger for project, CRM, creator, learning, family, finance, travel, teaching, legal, or team workbenches. Do not trigger for marketing sites, one-off scripts, ordinary coding tasks, or informational questions.

FileKindSize
LICENSEother520 B
SKILL.mdskill md6.3 KB
THIRD_PARTY_NOTICES.mdmarkdown1.4 KB
agents/openai.yamlconfig340 B
references/data-lifecycle.mdmarkdown3.0 KB
references/delivery-deployment.mdmarkdown3.3 KB
references/deployment-options.mdmarkdown3.8 KB
references/interview-and-levels.mdmarkdown5.4 KB
references/iteration-and-recovery.mdmarkdown2.1 KB
references/licenses/MIT-HIG-Doctor.txtmarkdown1.3 KB
references/licenses/MIT-Taste-Skill.txtmarkdown1.0 KB
references/licenses/MIT-UI-UX-Pro-Max.txtmarkdown1.0 KB
references/module-contract.mdmarkdown2.6 KB
references/privacy-security.mdmarkdown2.3 KB
references/prompt-pack.mdmarkdown3.6 KB
references/source-registry.jsonconfig2.7 KB
references/ui-audit.mdmarkdown1.6 KB
references/ui-quality.mdmarkdown4.5 KB
references/verification-contract.mdmarkdown2.9 KB
references/workbench-spec-template.mdmarkdown5.0 KB
scripts/create_spec.pyscript9.5 KB
scripts/ui_design_intelligence/core.pyscript16.6 KB
scripts/ui_design_intelligence/data/app-interface.csvother9.5 KB
scripts/ui_design_intelligence/data/charts.csvother18.9 KB
scripts/ui_design_intelligence/data/colors.csvother37.8 KB
scripts/ui_design_intelligence/data/icons.csvother20.2 KB
scripts/ui_design_intelligence/data/motion.csvother10.3 KB
scripts/ui_design_intelligence/data/products.csvother71.8 KB
scripts/ui_design_intelligence/data/stacks/astro.csvother11.6 KB
scripts/ui_design_intelligence/data/stacks/html-tailwind.csvother11.0 KB
scripts/ui_design_intelligence/data/stacks/nextjs.csvother12.2 KB
scripts/ui_design_intelligence/data/stacks/react.csvother12.7 KB
scripts/ui_design_intelligence/data/stacks/shadcn.csvother15.5 KB
scripts/ui_design_intelligence/data/stacks/vue.csvother10.7 KB
scripts/ui_design_intelligence/data/styles.csvother139.3 KB
scripts/ui_design_intelligence/data/typography.csvother48.7 KB
scripts/ui_design_intelligence/data/ui-reasoning.csvother51.7 KB
scripts/ui_design_intelligence/data/ux-guidelines.csvother18.2 KB
scripts/ui_design_intelligence/validate_data.pyscript4.1 KB
scripts/ui_design_intelligence/workbench_design.pyscript12.1 KB
scripts/workflow_guard.pyscript15.0 KB

references/module-contract.md

View on GitHub
# Module And Storage Contract

Read this file when defining application architecture, module boundaries, persistence adapters, or generated metadata.

## Workbench manifest

Create `workbench-manifest.json` for every direct build:

```json
{
  "generatedBy": "personal-workbench-builder",
  "skillVersion": "1.0.0",
  "appVersion": "1.0.0",
  "schemaVersion": 1,
  "generatedAt": "2026-08-03T03:00:00Z",
  "complexity": "L2",
  "deploymentProfile": "hosted-static",
  "modules": [
    {"id": "ideas", "version": "1.0.0", "schemaVersion": 1, "status": "ready"}
  ]
}
```

Use semantic application versions. Keep `schemaVersion` numeric and independent from `appVersion`. Do not reuse a PWA web manifest as this workbench manifest.

## Module boundaries

For each module record:

- Stable lowercase ID and owned routes or views.
- Data namespace or entities it owns.
- Inputs, outputs, events, and read/write permissions.
- Module and data schema versions.
- Requirement and acceptance IDs implemented by the module.
- Empty, loading, error, permission, and offline behavior where applicable.

A module must not edit another module's DOM, files, tables, or storage directly. Use declared events or read-only/query interfaces for cross-module consumption, and an explicit command interface for approved cross-module writes.

## Async storage adapter

Keep business modules independent from browser, file, SQLite, or cloud details. Provide asynchronous equivalents of:

```text
read(namespace, key)
write(namespace, key, value)
remove(namespace, key)
list(namespace, query?)
export()
import(envelope, { mode: "merge" | "overwrite" })
```

All methods return promises or the stack's equivalent asynchronous result. `import` returns `added`, `merged`, `overwritten`, `skipped`, and `failed` counts. Modules must not call `localStorage`, IndexedDB, SQL, filesystem APIs, or cloud SDKs outside the selected adapter.

The adapter must preserve the data-lifecycle rules in [data-lifecycle.md](data-lifecycle.md): validate before writes, migrate on a copy, back up before overwrite, and leave current data unchanged on failure.

## Architecture selection

- Use the project's existing stack when it meets the confirmed requirements.
- Add an adapter implementation only for the selected persistence profile; do not prebuild unused cloud or local-service layers.
- Keep secrets and privileged writes behind a server boundary.
- Treat a change from local storage to synchronized storage as a data migration, with export, count reconciliation, and rollback evidence.
- Treat a platform rewrite, such as web to a native mini-program, as a separate implementation unless the runtime is demonstrably compatible.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall