Skip to content

cskwork/supergoal-skill / skills/supergoal

supergoal

Unverified

Route objective-driven development, verification, planning, "teach/explain", codebase learning, and skill evaluation through the Supergoal workflow. Use when Supergoal is requested or an autonomous delivery workflow is needed.

FileKindSize
SKILL.mdskill md12.8 KB
agents/analyst.mdmarkdown1.5 KB
agents/architect.mdmarkdown1.7 KB
agents/code-reviewer.mdmarkdown2.5 KB
agents/db-reader.mdmarkdown2.0 KB
agents/debugger.mdmarkdown2.0 KB
agents/designer.mdmarkdown6.3 KB
agents/executor.mdmarkdown2.8 KB
agents/explore.mdmarkdown2.0 KB
agents/qa-auditor.mdmarkdown4.3 KB
agents/qa-tester.mdmarkdown3.2 KB
agents/security-reviewer.mdmarkdown1.2 KB
agents/skill-forger.mdmarkdown1.6 KB
agents/skill-miner.mdmarkdown1.6 KB
reference/agent-browser.mdmarkdown2.8 KB
reference/arch.mdmarkdown5.1 KB
reference/archify.mdmarkdown3.6 KB
reference/db-access.mdmarkdown2.9 KB
reference/debugging.mdmarkdown6.5 KB
reference/delivery-gate.mdmarkdown6.6 KB
reference/domain-context.mdmarkdown7.8 KB
reference/domain-rules.mdmarkdown1.6 KB
reference/engagement.mdmarkdown3.8 KB
reference/functional-ui.mdmarkdown6.4 KB
reference/harness-eval.mdmarkdown28.7 KB
reference/interview.mdmarkdown7.7 KB
reference/learn-domain.mdmarkdown12.7 KB
reference/market-research.mdmarkdown1.7 KB
reference/observability.mdmarkdown5.0 KB
reference/plan-grounding.mdmarkdown4.3 KB
reference/playwright-cli.mdmarkdown2.6 KB
reference/prototype.mdmarkdown4.5 KB
reference/qa-only.mdmarkdown12.7 KB
reference/qa.mdmarkdown7.9 KB
reference/reporting.mdmarkdown1.5 KB
reference/research.mdmarkdown2.7 KB
reference/review-only.mdmarkdown2.4 KB
reference/role-loop.mdmarkdown26.7 KB
reference/rules.mdmarkdown982 B
reference/skill-mine.mdmarkdown7.6 KB
reference/taste-aesthetics.mdmarkdown7.5 KB
reference/taste-skill-v2.mdmarkdown18.8 KB
reference/taste-sources.mdmarkdown3.0 KB
reference/teach.mdmarkdown28.0 KB
reference/ui-ux.mdmarkdown4.0 KB
reference/vercel-host.mdmarkdown3.6 KB
reference/wayfinder.mdmarkdown7.2 KB
templates/GOAL.mdmarkdown1.3 KB
templates/PLAN.mdmarkdown1.4 KB
templates/QA.mdmarkdown1.2 KB
templates/R-LOOP.mdmarkdown569 B
templates/Z-DONE.mdmarkdown301 B
templates/arch-report.htmlother8.1 KB
templates/commit-gate.shexecutablescript11.6 KB
templates/contrast-gate.mjsexecutablescript4.3 KB
templates/db-access/.env.exampleother451 B
templates/db-access/check-connection.shexecutablescript134 B
templates/db-access/db-access.cmdscript39 B
templates/db-access/db-access.mjsexecutablescript5.2 KB
templates/db-access/read-only-query.shexecutablescript138 B
templates/db-access/schema-summary.shexecutablescript132 B
templates/domain-agent/code-map.mdmarkdown744 B
templates/domain-agent/config.jsonconfig291 B
templates/domain-agent/decisions/README.mdmarkdown270 B
templates/domain-agent/flows/README.mdmarkdown800 B
templates/domain-agent/freshness.mdmarkdown1.2 KB
templates/domain-agent/glossary.mdmarkdown781 B
templates/domain-agent/index.mdmarkdown1.3 KB
templates/domain-agent/invariants.mdmarkdown504 B
templates/domain-agent/qa/README.mdmarkdown879 B
templates/domain-agent/qa/nav-map.mdmarkdown1.2 KB
templates/domain-agent/test-map.mdmarkdown432 B
templates/domain-agent/tickets/README.mdmarkdown204 B
templates/domain-onboarding.htmlother9.2 KB
templates/harness-eval-case.yamlconfig4.4 KB
templates/harness-eval-cases/authored/authored-underspec-001-deepmerge.yamlconfig2.2 KB
templates/harness-eval-cases/authored/authored-underspec-002-csvline.yamlconfig2.0 KB
templates/harness-eval-cases/authored/authored-underspec-003-authz-cache.yamlconfig1.6 KB
templates/harness-eval-cases/fixtures/README.mdmarkdown2.8 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/src/cache.mjsscript494 B
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-002-async-race/test/cache.visible.test.mjsscript950 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/package.jsonmanifest125 B
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/src/order.mjsscript1.3 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.hidden.test.mjsscript2.2 KB
templates/harness-eval-cases/fixtures/revfactory-case-003-refactoring/test/order.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/package.jsonmanifest124 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/src/merge.mjsscript84 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.hidden.test.mjsscript1013 B
templates/harness-eval-cases/fixtures/underspec-001-deepmerge/test/merge.visible.test.mjsscript276 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/package.jsonmanifest122 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/src/csv.mjsscript77 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.hidden.test.mjsscript804 B
templates/harness-eval-cases/fixtures/underspec-002-csvline/test/csv.visible.test.mjsscript240 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/package.jsonmanifest126 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/src/authorizer.mjsscript601 B
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.hidden.test.mjsscript3.8 KB
templates/harness-eval-cases/fixtures/underspec-003-authz-cache/test/authorizer.visible.test.mjsscript1.2 KB
templates/harness-eval-cases/revfactory-case-001-rest-api.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-002-bug-fix.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-003-refactoring.yamlconfig2.4 KB
templates/harness-eval-cases/revfactory-case-004-documentation.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-005-complex.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-006-research.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-007-interpreter.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-008-microservice.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-009-sql-engine.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-010-crdt.yamlconfig2.0 KB
templates/harness-eval-cases/revfactory-case-011-raft-kv.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-012-spreadsheet.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-013-bytecode-vm.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-014-event-sourcing.yamlconfig2.1 KB
templates/harness-eval-cases/revfactory-case-015-lsp.yamlconfig2.3 KB
templates/harness-eval-cases/run-local-eval.mjsscript43.3 KB
templates/harness-eval-cases/run-underspec-n3.mjsscript41.1 KB
templates/harness-eval-external/deepswe/README.mdmarkdown9.9 KB
templates/harness-eval-external/deepswe/prepare-supergoal-arm.mjsscript4.4 KB
templates/harness-eval-external/deepswe/run-default-suite.mjsscript6.1 KB
templates/harness-eval-external/deepswe/run-full-cycle.mjsscript25.3 KB
templates/harness-eval-external/deepswe/task-set.yamlconfig12.2 KB
templates/harness-eval-external/featadd/README.mdmarkdown3.9 KB
templates/harness-eval-external/featadd/features.tsvother1.6 KB
templates/harness-eval-external/featadd/gen.shscript4.0 KB
templates/harness-eval-external/featadd/package.pyscript6.2 KB
templates/harness-eval-gate.mjsscript24.9 KB
templates/harness-eval-report.mdmarkdown5.8 KB
templates/harness-eval-result.jsonconfig11.9 KB
templates/harness-eval-runner.mjsscript19.9 KB
templates/harness-eval-stats.mjsscript1.8 KB
templates/learn-grounding-gate.mjsscript6.1 KB
templates/observability/heartbeat.schema.jsonconfig2.5 KB
templates/observability/sg-emit.shexecutablescript5.4 KB
templates/qa-gate.shexecutablescript6.9 KB
templates/qa-only-gate.shexecutablescript5.1 KB
templates/qa-report.mdmarkdown2.8 KB
templates/rules.mdmarkdown301 B
templates/run-state-gate.mjsscript2.2 KB
templates/run-state.jsonconfig474 B
templates/skill-frontmatter-gate.mjsscript3.7 KB
templates/skill-install-audit.mjsexecutablescript3.7 KB
templates/skill-mine/mine.mjsscript7.8 KB
templates/skill.md.templateother568 B
templates/teach-lesson-gate.mjsscript5.4 KB
templates/teach/README.mdmarkdown4.1 KB
templates/teach/assets/lesson-book.jsscript5.8 KB
templates/teach/assets/lesson-template.htmlother6.1 KB
templates/teach/assets/lesson.cssother11.8 KB
templates/teach/assets/quiz.jsscript3.2 KB

reference/functional-ui.md

View on GitHub
# Functional UI - density + states overlay for dense/admin surfaces

Load when the surface is a dashboard, data table, admin panel, internal tool, settings, wizard, or
CRUD form. Layered on top of the Expressive baseline (`reference/taste-skill-v2.md` stays the polish
authority); never an alternative tier, never lowers polish. Mixed product: Expressive everywhere,
this overlay only on the dense surfaces.

Relative to taste-skill-v2 it suppresses landing-only rules (hero, marquee, scroll-choreography,
anti-slop landing) and adds density discipline plus complete UI states. Phases, gates, vault, topology
unchanged. One Designer driver per surface.

## Non-negotiable baseline

- **Design system.** Pick exactly one and do not hand-roll or mix. Map the brief:
  enterprise SaaS -> Fluent; analytics/B2B -> Carbon; Material product -> Material 3;
  Shopify admin -> Polaris; Atlassian/Jira -> Atlaskit; accessible React base -> Radix Themes;
  owned modern SaaS -> shadcn/ui. (Same table as taste-skill-v2 section 2.)
- **Contrast computed, not eyeballed.** Body AAA (>=7:1), all other text AA (>=4.5 normal, >=3 large)
  on its actual background. Enumerate pairs to `<vault>/qa/contrast-pairs.json`; gate computes them.
- **One accent, one type scale, one spacing scale, one radius system.** Consistent across every view.
- **All UI states implemented.** loading (skeleton), empty, error, focus, hover, active, disabled.
  Tables also need: empty state, loading state, error state, pagination/sort affordance.
- **Density first.** `VISUAL_DENSITY` high (7-10): tight rows, mono/tabular numbers, lines over cards.
  Cards only when elevation conveys hierarchy.
- **Motion minimal.** `MOTION_INTENSITY` low (1-3): hover/active/feedback only. No choreography,
  parallax, or perpetual loops. Any motion above 3 honors `prefers-reduced-motion`.
- **Theme declared.** Set `color-scheme`; ship both light/dark tokens or a justified single-mode lock.
- **No empty decoration.** Every element carries data or a labeled control. No placeholder panels.

## Data-app techniques (dashboards, analytics, consoles, admin at scale)

Density-first depth for a real data app. No marketing hero: the landing heuristics (centered hero,
hero-fits-viewport, logo wall, 1-3-word CTA, eyebrow/zigzag) do not apply here - do not fire them. Keep
the baseline's density-first dials (high `VISUAL_DENSITY`, low `MOTION_INTENSITY`, low `DESIGN_VARIANCE`).
Open with an app shell + a KPI summary row, north-star metric top-left. Every universal ban still holds.

- **App shell.** Collapsible icon-rail sidebar + topbar (breadcrumbs, global search, account,
  theme/density) + scrollable content; persist collapse across routes. Command palette (Cmd/Ctrl+K,
  `cmdk`) covering nav + actions + record search. Roving tabindex inside tables; visible focus ring; no
  pointer-only actions.
- **Data tables.** Headless-first TanStack Table (own the markup). MUI X DataGrid only inside an MUI app;
  AG Grid for enterprise grids (pivot/group/aggregate; server-side row model past ~100k rows). Virtualize
  past ~50 unpaginated rows (overscan 5-10, not 25). Left-align text, right-align numbers,
  `font-variant-numeric: tabular-nums` on every numeric column. Sticky header + first column; sort,
  faceted filters, column pin/resize/show-hide, row-select + bulk actions. Keep sort/filter/pagination in
  URL params (shareable, back-safe). Never ship the default Alpine/MUI look.
- **Charts (pick by data scale, then retheme).** Recharts/Tremor for small-medium KPI cards (SVG, drops
  past a few thousand points) -> Nivo/visx for many-type or bespoke D3 -> ECharts/uPlot (Canvas/WebGL) for
  big-data, real-time, or streaming (lazy-load, heavy). Every chart needs a data-table fallback + ARIA
  (WCAG 1.4.1). High data-ink ratio, direct labels over legends, no chartjunk (no 3D/gauges/rainbow); pie
  max 3 slices; bars ordered by value.
- **KPI cards.** label + big tabular value + delta-vs-baseline (or target) + sparkline. A number with no
  delta/target is "just a number". 5-7 primary KPIs max; gauges are deprecated.
- **Status color, colorblind-safe.** Color carries status/severity meaning only; everything else neutral.
  Okabe-Ito / Wong palette; prefer blue-orange over red-green; ALWAYS a redundant non-color cue
  (icon/shape/label); 6 categorical max. Color-only status fails ~8% of men and breaks in grayscale.
- **Per-widget states.** Skeleton sized to the final content (no full-page spinner for one slow widget);
  empty = one purpose line + the first action (distinguish zero-data / no-permission / error); error =
  plain cause + inline retry. Live surfaces show a last-updated / freshness tick; animated counters use
  `tabular-nums`. Never show mock data as if it were real - label any mock.
- **Dark-first elevation.** Off-black canvas (e.g. `#0B0D0F`, never `#000`); depth by lightness (tinted
  surface elevations + hairline borders + soft glow), not drop shadows. Ship a tested light mode via token
  swap, never a late CSS invert.
- **Enterprise systems (lean on one, never mix).** Carbon (most explicit density + data-viz spec), Ant
  Design Pro (broadest tables), Fluent 2 (Microsoft/Office), Cloudscape (formal comfortable/compact). Use
  one whole; do not mix Carbon tables with AntD inputs and an MUI grid so spacing/tokens fight.
- **Ban:** marketing-hero thinking on a data app; KPI overload (>12, no dominant metric, equal-weight
  grid); chartjunk; wrong renderer for scale (SVG for millions of points, 10k+ rows with no
  virtualization); color-only status; proportional or center-aligned number columns; tables >50 rows with
  no virtualization/pagination; missing or conflated loading/empty/error states; two design systems mixed;
  pure `#000`/`#fff` dark mode.

## Frame overlay

Add a one-line **Design Read** (surface kind + chosen design system) and the three dials
(`DESIGN_VARIANCE` low/symmetric, `MOTION_INTENSITY` 1-3, `VISUAL_DENSITY` 7-10) to `PLAN.md`.

## Build overlay

Dispatch **Designer** with `PLAN.md` + this file as the authority. Enforce the baseline above.
No self-approval.

## QA overlay

Run beside normal QA: a11y (keyboard focus, labels), reduced motion, all UI states present, density
matches dials, `color-scheme` declared. Record `UI-tier: Functional` in `QA.md` `## QA` and
enumerate every text/bg pair to `<vault>/qa/contrast-pairs.json`; `qa-gate.sh` runs
`node templates/contrast-gate.mjs` on it (completeness critic audits the pair list). Any fail rewinds
to Build and blocks delivery.
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: 471kUpdated 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