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/command-animate.md

View on GitHub
# animate — motion that explains

**Job:** use motion for feedback, state change and continuity, plus at most one authored moment
the surface has earned. Remove motion that does none of those.

**Run when:** the detector reports `missing-reduced-motion`, `transition-all`,
`layout-property-motion`, `bounce-easing`, `decorative-pulse`, `marquee-scroll` or
`blinking-cursor`; a critique
calls the page "jittery", "slow" or "static where state changes".

## By mode

- **Persuade / Showcase:** one rehearsed focal sequence beats a fade-and-rise on every section.
- **Operate / Read:** fast feedback, continuity on navigation and layout change; no load
  choreography that makes people wait.

## Change

- **Reduced motion:** every animation gets a `prefers-reduced-motion: reduce` path (or
  `motion-safe:` utilities) that removes movement but keeps meaningful opacity and colour changes.
- **Properties:** name them. `transition: all` and bare-duration shorthands become explicit
  lists (`opacity, transform, background-color`).
- **Layout work:** animations of width, height, top, left, margin or padding become transform /
  opacity, a grid-rows technique, or a FLIP transition.
- **Easing:** decelerating curves for arrivals (for example `cubic-bezier(0.2, 0.8, 0.2, 1)`);
  exits faster than entrances; no bounce or overshoot unless the subject literally bounces.
- **Durations:** 100-150ms feedback, 150-300ms state change, 300-500ms overlays and view changes,
  up to 800ms for one authored entrance.
- **Idle loops:** pulsing dots, marquees and endless shimmer stop unless they track live data;
  any loop stops when off-screen and offers pause.
- **Visible by default:** content is visible without JavaScript; reveal animations start from an
  already-readable state.

## Do not touch

- The surface's visual design and copy.
- Motion that carries real meaning (progress, live data); refine its timing instead of removing it.

## Steps

1. List every animation and transition in the target. For each, write its job: feedback, state,
   continuity, attention, or none.
2. Remove the "none" items. Fix properties, easing and duration on the rest.
3. Add the reduced-motion path in the same change.
4. Choose the focal moment, if any, and make it specific to this product.

## Verify

- Detector `--scope motion` exits 0 on the target.
- With the OS reduced-motion setting on, nothing slides or scales; state changes are still visible.
- A performance recording of the main interaction shows no layout work during animation.
- Interrupting an animation (clicking twice, navigating away) leaves no broken state.

## Hand-off

`polish`.
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: 321kUpdated 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