Skip to content

borghei/Claude-Skills / engineering/interface-refinement

interface-refinement

Verified

Refine an existing interface with named commands (critique, polish, distill, typeset, colorize ...), a product and design context file, and a static detector of generic UI patterns. Use when UI looks generic, cluttered or unfinished.

FileKindSize
SKILL.mdskill md22.1 KB
assets/interface-context-template.mdmarkdown2.6 KB
assets/refinement-report-template.mdmarkdown1.5 KB
assets/sample_context.mdmarkdown3.8 KB
assets/sample_context_flawed.mdmarkdown730 B
assets/sample_detector_report.jsonconfig387 B
assets/sample_detector_report_flawed.jsonconfig48.8 KB
assets/sample_refinement_plan.jsonconfig1.7 KB
assets/sample_refinement_plan_flawed.jsonconfig893 B
assets/sample_ui_flawed.cssother2.5 KB
assets/sample_ui_flawed.htmlother4.5 KB
assets/sample_ui_flawed.tsxother1.1 KB
assets/sample_ui_sound.cssother2.3 KB
assets/sample_ui_sound.htmlother2.6 KB
assets/sample_ui_sound.tsxother1.3 KB
references/command-adapt.mdmarkdown2.7 KB
references/command-animate.mdmarkdown2.6 KB
references/command-audit.mdmarkdown3.5 KB
references/command-bolder.mdmarkdown3.2 KB
references/command-clarify.mdmarkdown2.8 KB
references/command-colorize.mdmarkdown2.7 KB
references/command-critique.mdmarkdown3.5 KB
references/command-delight.mdmarkdown1.8 KB
references/command-distill.mdmarkdown2.3 KB
references/command-document.mdmarkdown3.3 KB
references/command-extract.mdmarkdown3.4 KB
references/command-harden.mdmarkdown2.5 KB
references/command-init.mdmarkdown2.9 KB
references/command-layout.mdmarkdown2.3 KB
references/command-onboard.mdmarkdown2.2 KB
references/command-optimize.mdmarkdown3.4 KB
references/command-polish.mdmarkdown2.8 KB
references/command-quieter.mdmarkdown2.3 KB
references/command-typeset.mdmarkdown2.9 KB
references/craft-floor.mdmarkdown3.7 KB
references/detector-rules.jsonconfig22.6 KB
references/detector-rules.mdmarkdown14.5 KB
references/native-platforms.mdmarkdown4.6 KB
references/review-protocol.mdmarkdown5.2 KB
references/surface-modes.mdmarkdown3.4 KB
scripts/class_checks.pyscript12.3 KB
scripts/command_router.pyscript12.7 KB
scripts/context_linter.pyscript13.4 KB
scripts/css_checks.pyscript12.3 KB
scripts/css_parse.pyscript7.6 KB
scripts/extra_checks.pyscript12.7 KB
scripts/markup_checks.pyscript14.6 KB
scripts/system_checks.pyscript9.4 KB
scripts/ui_rules.pyscript12.5 KB
scripts/ui_slop_detector.pyscript12.1 KB

references/native-platforms.md

View on GitHub
# Native platforms: iOS and Android

Use this when the context file's platform is `ios`, `android` or `cross-platform`. On native, the
platform's conventions govern structure, navigation and interaction in every mode; the brand
expresses through what the platform leaves open (tint, type in display moments, motion
character, content). The web detector does not read Swift, Kotlin or Dart; it applies to
React Native or Flutter web output only. Never report its empty result on native code as clean.

## The trust test

Would a fluent user of this platform trust the app, or pause at a control that behaves wrongly?
The tell on iOS is "a website in a wrapper": custom navigation bars, a broken back swipe, web-shaped
buttons, hover affordances. The tell on Android is "an iPhone app in disguise": bottom-only
navigation on a tablet, a back arrow that ignores system Back, Cupertino switches and dialogs.

## Checks

| Area | iOS / iPadOS | Android |
|------|--------------|---------|
| Layout | content inside safe-area insets; nothing under the notch, Dynamic Island or home indicator | edge-to-edge with window insets for status bar, navigation bar, cutout and keyboard |
| Navigation | tab bar for 2-5 top-level sections, navigation stack for depth, sheets for self-contained tasks | navigation bar (3-5 destinations) on compact width; rail or drawer on expanded width |
| Back | left-edge swipe always works; never overlaid or disabled | predictive Back gesture and Back button always work; never trap the user |
| Titles | large titles on top-level screens collapsing on scroll | top app bar carries screen context; one FAB for the single primary action |
| Touch targets | 44 x 44 pt minimum with room between | 48 x 48 dp minimum, 8 dp apart |
| Type | system text styles so Dynamic Type works; 11 pt floor, Body 17 pt; brand face only in display moments | Material type roles (display, headline, title, body, label); `sp` units so font scale works |
| Colour | semantic system colours (label, secondaryLabel, systemBackground, tint); one tint drives interaction | Material colour roles (primary, on-primary, surface, outline, error); Dynamic Color where it fits |
| Dark | Dark Mode designed and tested, not inverted | dark theme designed and tested; tonal elevation, not arbitrary shadows |
| Controls | system switch, segmented control, pickers, action sheets, context menus, swipe actions | Material buttons (filled/tonal/outlined/text), chips, switches, snackbars, bottom sheets, dialogs |
| Icons | SF Symbols, weight matched to text | Material Symbols |
| Motion | push, sheet and dismiss transitions from the system; Reduce Motion swaps slides for crossfades | container transform, shared axis, fade through; Remove animations gives a crossfade or cut |

## Native audit dimensions (replace the web five)

1. **Accessibility:** VoiceOver / TalkBack labels and traits on every control, logical focus
   order, Dynamic Type / font scale to the largest size without truncation, increased contrast.
2. **Performance:** dropped frames on scroll and transitions, main-thread work on launch, image
   decoding off the main thread.
3. **Appearance:** light and dark, increased contrast, tint and colour roles instead of literals.
4. **Platform conformance:** navigation model, back behaviour, native controls, targets, modality.
5. **Adaptivity:** size classes / window size classes, orientation, split view and multi-window,
   foldable postures.

## Translating between platforms

Translate idioms, never transplant them:

| iOS | Android | Web |
|-----|---------|-----|
| tab bar | navigation bar / rail / drawer | top nav or side rail |
| edge-swipe back, back chevron | predictive Back | browser back, breadcrumb |
| segmented control | chips or segmented button | tabs or radio group |
| action sheet | bottom sheet or dialog | menu or dialog |
| SF Symbols, SF Pro, Dynamic Type | Material Symbols, Roboto, sp | one icon set, the product's faces, rem |
| system materials | tonal elevation | shadow tokens |

Carry the brand's expressive layer (palette intent, type accent, motion personality) through each
platform's theming system.

## Evidence

Screenshots come from the simulator or emulator or a device, never from a browser preview of
native code. iOS: `xcrun simctl io booted screenshot <path>`; flip appearance with
`xcrun simctl ui booted appearance dark`. Android: `adb exec-out screencap -p > <path>`; dark theme
with `adb shell cmd uimode night yes`; font scale with `adb shell settings put system font_scale 1.3`
(read and restore the original values). Capture every device class the app ships to. Simulators
give breadth; gestures, refresh rate and performance need hardware. Say which produced the evidence.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall