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/ui-quality.md

View on GitHub
# Workbench UI Quality

Read this file before generating a workbench design system.

## Visual brief

Record the product, primary user, repeated workflow, usage frequency, technical comfort, desired character, formality, information density, mobile priority, and implementation stack. Ask only for missing choices that would materially change the interface.

If the user provides screenshots, an existing brand, or a named repository, record a visual fingerprint covering layout, navigation, typography, color ratio, borders, shadows, component silhouette, background, icons, motion, and mobile transformation. These references override generic recommendations for the current project. Review licenses before copying any source or asset.

Before extracting the fingerprint, classify visible material as intended UI or capture/presentation artifact. Treat phone status bars, browser tabs and address bars, screenshot watermarks, transparent checkerboards, device frames, and surrounding presentation containers as noise unless the user explicitly identifies one as part of the desired interface. Preserve this classification in the specification.

Choose three explicit dials from 1-10:

- expression: visual personality without reducing task clarity.
- motion: interaction feedback, not decorative spectacle.
- density: information visible per viewport.

Default operational systems to expression 5, motion 3, density 7. Default personal learning or life systems to expression 7, motion 4, density 5. Change the defaults from user evidence.

## Dynamic design system

Run scripts/ui_design_intelligence/workbench_design.py with the complete brief. It uses the embedded, MIT-licensed UI UX Pro Max search engine and workbench-relevant product, style, color, typography, UX, icon, chart, motion, and stack data.

Persist design-system/MASTER.md and system.json. Add design-system/pages/<page>.md only when a page genuinely differs from the shared system. Never present fixed visual directions or copy a bundled UI project.

Use the generated recommendations as decision support, not as unquestionable output. Resolve weak matches against the confirmed workflow. Explicit references remain authoritative and UI UX Pro Max fills only unspecified gaps.

## Composition rules

- Build around repeated work and the user's next decision, not promotional content.
- Choose tables, timelines, calendars, split panes, queues, editors, maps, or command surfaces when they communicate the workflow better than cards.
- Do not nest cards or use a generic card grid as the information architecture.
- Use hierarchy, typography, spacing, and domain-specific components before decorative surfaces.
- Use one coherent icon family. Remove third-party logos and assets without redistribution permission.
- Keep every visible control functional. Omit unavailable actions.
- Design empty, loading, error, success, permission-denied, and offline states.

## Theme and responsive contract

Define semantic tokens for canvas, surfaces, elevated surfaces, primary text, secondary text, borders, accent, focus, success, warning, and danger. Implement only the theme behavior required by the confirmed specification:

- For one fixed theme, implement and test that theme without adding a theme setting.
- For a light/dark toggle, implement both themes and persist the explicit choice.
- For system following, implement both token sets and react to operating-system changes while `system` is selected.

Do not add light/dark/system controls merely because they are technically possible.

Desktop and phone layouts are separate compositions of the same workflow. Replace desktop navigation with a drawer, compact top navigation, or bottom navigation on phones. Keep touch targets at least 44px and prevent dynamic content from resizing controls.

Verify normal text at 4.5:1 contrast, large text at 3:1, visible keyboard focus, reduced motion, text wrapping, zoom, empty states, error recovery, and absence of horizontal overflow.

## Confirmation and audit

Render desktop and phone prototypes for every new or materially changed interface. Keep `ui_confirmation_status` at `awaiting-confirmation` until the user explicitly approves the visual direction. When an existing approved design is unchanged, set it to `inherited-without-change` and record the prior evidence and comparison. A required UI gate blocks development until approval.

Use the MIT-licensed Taste Skill adaptation only for anti-generic visual review and the HIG Doctor workflow only for accessibility and interaction auditing. Neither chooses the design direction. Source details are pinned in source-registry.json.


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