borghei/Claude-Skills / engineering/interface-refinement
interface-refinement
VerifiedRefine 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.
references/command-delight.md
View on GitHub# delight — one considered moment
**Job:** add product character at a moment that earns it: a completed task, a recovered error, a
first success. Delight is specific to this product or it is noise.
**Run when:** the owner asks; a critique says the surface is correct but forgettable. Never routed
from the detector. The router drops it on operate and read surfaces unless asked.
## Change
- Write one sentence: what the person should feel, at which moment, and why that feeling belongs
to this product. If the sentence could describe any product, start again.
- Pick the smallest carrier: a response to a meaningful action, product-specific wording, a
transition with a recognisable material behaviour, a small illustration or sound grounded in the
product's world, a discovery that reveals real utility.
- Scale it to frequency and stakes: a milestone may expand; a routine save just feels certain.
## Do not touch
- Speed and clarity of the task. Delight never delays, blocks or hides the primary action.
- Serious moments: money, deletion, privacy, access loss get warmth at most, never jokes.
- Defaults: no sound without consent, nothing mandatory or unskippable, nothing that tires on the
hundredth repeat.
- Claims: delight copy invents no facts.
## Steps
1. Find the candidate moments (effort completed, wait, first use, recovery, mastery).
2. Choose one. Write the delight sentence.
3. Build it with the existing system; motion follows `animate` rules, copy follows `clarify` rules.
## Verify
- The moment could not ship unchanged on a neighbouring product.
- The task is as fast with the flourish as without it (time it).
- Muted, keyboard, touch, reduced-motion and translated paths all work.
- Repeat it ten times; it is still pleasant or it gets quieter.
## Hand-off
`polish`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |