polished-app-gate

Audit kid-visible and TheSpine UI polish with screenshot and DOM evidence.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/blucsigma05/tbm-apps-script --skill polished-app-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polished-app-gate
Source: https://github.com/blucsigma05/tbm-apps-script/tree/main/.claude/skills/polished-app-gate
Command: npx skills add https://github.com/blucsigma05/tbm-apps-script --skill polished-app-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams avoid shipping kid-visible or office-facing UI that feels like a prototype by adding a non-deterministic “polish” verdict above the deterministic MVSS/route/CSS/button-wiring checks.

Core Features & Use Cases

  • Opt-in polish verdicts for PRs labeled with gate:polish, producing a ship/ship-with-backlog/do-not-ship decision.
  • Scoped visual/aesthetic audits across kid-visible lanes (Buggsy, JJ) and JT’s TheSpine command surface, including prototype-like micro-state and copy/cadence issues.
  • Evidence-driven findings using required screenshot + frozen rendered DOM context, optionally targeting Spine trust/readability signals.

Quick Start

Run polished-app-gate on PR #1234 after adding the gate:polish label and freezing the required device screenshots and DOM context for the updated route(s).

Frequently Asked Questions about polished-app-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a UI polish audit to check if my front-end feels prototyped?

Run a UI polish audit by applying a gate:polish label to your PR and providing screenshot plus frozen rendered DOM context. The audit checks kid-visible surfaces and emits a ship, ship-with-backlog, or do-not-ship verdict.

What is the difference between a polished UI and a prototype in front-end reviews?

A polished UI avoids prototype-like micro-states, copy issues, and visual cadence problems. Aesthetic reviews enforce axis-based checks across P1–P5 levels, with optional P6 for command surfaces, to distinguish production-ready interfaces from unfinished prototypes.

How do I enforce phase-0 bake-off readiness for kid-visible web surfaces?

Enforce phase-0 bake-off readiness by running opt-in polish verdicts on targeted kid-visible routes. The gate requires device-profile resolution and screenshot evidence to validate that the UI meets aesthetic standards before shipping.

Does the aesthetic review require any specific environment setup or evidence?

Yes, aesthetic reviews require a configured single gate model, screenshot evidence, and frozen rendered DOM context for the targeted routes. You must freeze device screenshots and DOM context for the updated surfaces before running the audit.

Can I use this UI audit for non-kid-visible office-facing surfaces?

Yes, the UI audit applies to both kid-visible lanes and office-facing command surfaces like TheSpine. It evaluates prototype-like micro-states and copy/cadence issues across these scoped surfaces to determine if they feel polished.

What limitations exist when running a polish verdict on PRs without DOM context?

Polish verdicts cannot run without screenshot and frozen rendered DOM context evidence. The gate enforces this requirement to ensure accurate axis-based aesthetic checks and device-profile resolution before emitting a valid JSON verdict.