name	buildable-reviewer
description	Use when reviewing generated Buildable prototypes for build correctness, UI completeness, state coverage, accessibility, responsiveness, and local-first discipline.

Buildable Reviewer Skill

Use this skill to review generated prototypes against the app spec and quality rubric.

Resolve all referenced paths from the Buildable plugin or repository root.

buildable review is a static/local quality gate. Treat it as a strong first pass for structure, local-first guardrails, source coverage, responsive-layout risk, accessibility signals, and optional build checks; it does not replace manual QA, real device/simulator checks for mobile, or browser/screenshot review when visuals matter.

Activation

Use only when reviewing an app/prototype against Buildable specs or rubrics. Do not activate globally for ordinary code review.

Reference Loading Contract

Mandatory order:

Run buildable review from the selected app workspace when available. Pass a path only when reviewing a different folder.
Load the app spec and selected rubric.
Load only files related to reported issues.
Do not load all templates.
Do not load unrelated archetypes or starter source.

Workflow

Run buildable review when the CLI is available. Add --build only when the user wants typecheck/build scripts run and dependencies are installed.
Read the app spec and selected quality rubric.
Run available build, typecheck, lint, or test commands (or rely on review --build).
Inspect the generated UI when possible — start the app and run buildable preview --url <url> from the app workspace to render it, screenshot it, and catch runtime/visual errors that build checks miss.
Check required interactions, state coverage, responsive behavior, and accessibility.
Produce a focused fix list.
Apply fixes when operating as the active coding agent.

Review Priorities

build correctness
primary workflow
missing interactions
empty/loading/error states
mobile and desktop layout
accessible form controls
unnecessary backend or hosted features

Output Format

Lead with blocking issues, then polish issues, then checks run. If no issues remain, say so and note residual risks.

Buildable Reviewer Skill

Use this skill to review generated prototypes against the app spec and quality rubric.

Resolve all referenced paths from the Buildable plugin or repository root.

Activation

Use only when reviewing an app/prototype against Buildable specs or rubrics. Do not activate globally for ordinary code review.

Reference Loading Contract

Mandatory order:

Run buildable review from the selected app workspace when available. Pass a path only when reviewing a different folder.

Load the app spec and selected rubric.

Load only files related to reported issues.

Do not load all templates.

Do not load unrelated archetypes or starter source.

Workflow

Run buildable review when the CLI is available. Add --build only when the user wants typecheck/build scripts run and dependencies are installed.

Read the app spec and selected quality rubric.

Run available build, typecheck, lint, or test commands (or rely on review --build).

Inspect the generated UI when possible — start the app and run buildable preview --url <url> from the app workspace to render it, screenshot it, and catch runtime/visual errors that build checks miss.

Check required interactions, state coverage, responsive behavior, and accessibility.

Produce a focused fix list.

Apply fixes when operating as the active coding agent.

Review Priorities

build correctness

primary workflow

missing interactions

empty/loading/error states

mobile and desktop layout

accessible form controls

unnecessary backend or hosted features

Output Format

Lead with blocking issues, then polish issues, then checks run. If no issues remain, say so and note residual risks.

buildable-reviewer