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

assets/sample_context.md

View on GitHub
# Interface context: Ledgerly

## Platform

web

## Users and jobs

- Primary: owners of two-to-ten person service businesses who invoice clients themselves, usually at a laptop on Friday afternoon after the week's work is done.
- Job: find who has not paid, chase them without sounding rude, and raise next week's invoices in under ten minutes.
- Secondary: a part-time bookkeeper who exports the ledger once a month and needs the numbers to match the bank.

## Purpose and positioning

- Purpose: get a small business paid for work already done, with as little admin as possible.
- Positioning: reminders are drafted from the client's own payment history, so the first chase is polite and the third is firm without the owner writing either.

## Surfaces

- /invoices: operate - scan open and overdue invoices and send reminders in bulk
- /invoices/new: operate - raise a correct invoice from a saved client in one pass
- / (marketing home): persuade - show a sole trader that chasing money takes minutes, then start a free account
- /help: read - answer one billing question per page without making people call support

## Voice and terms

- Voice: plain and calm, like a good bookkeeper. Money is never a joke; overdue is stated as days, not shamed.
- Terms: invoice (never "bill"), client (never "customer"), reminder (never "dunning"), draft, sent, paid, overdue.
- Numbers: currency code before the amount (EUR 1,240.00); dates as 3 Oct, never 10/03.

## Evidence on hand

- Product screenshots of the invoice list and new-invoice form: assets/screens/
- Pricing table agreed with finance: docs/pricing-2026.md
- Testimonials: none yet, do not invent quotes or logos.
- Usage numbers: none published; do not show counts of users or invoices sent.

## Principles

- The overdue list is the home screen; everything else is one step away from it.
- Never make the owner retype what the ledger already knows.
- Money and dates are exact; friendliness lives in the words around them.

## Constraints

- Accessibility: WCAG 2.2 AA on every surface, keyboard-complete invoice flow.
- Locales: English and German at launch; German labels run roughly 30% longer.
- Browsers: current and previous major versions of Chrome, Safari, Firefox, Edge; 360px phones upward.

## Visual system

### Palette roles

- surface: #ffffff
- surface-sunken: #f3f5f7
- text: #1b2430
- text-muted: #4d5a6a
- action: #0b5cad
- action-text: #ffffff
- danger: #a3261b
- rule: #d5dbe2
- selection: #cfe3f7

### Type roles

- body: Source Sans 3, 16px/1.55, 400
- heading: Source Sans 3, 28px/1.2, 600
- subheading: Source Sans 3, 20px/1.3, 600
- label: Source Sans 3, 14px/1.4, 600
- figures: Source Sans 3 with tabular numerals, 16px/1.4, 400

### Spacing scale

- steps: 4, 8, 12, 16, 24, 40, 64

### Radius

- control: 6px
- container: 8px

### Elevation

- resting: none; rows and panels sit flat and are separated by the rule colour
- raised: 0 2px 8px rgba(27, 36, 48, 0.12) for menus and the date picker only

### Layout

- content width: 72rem, prose capped at 65ch
- grid: one column under 720px, list plus detail panel above it

### Components

- button: 6px radius, action fill for the one primary action per view, outline for the rest
- table: tabular numerals, amounts right-aligned, status as a coloured word, never a dot alone
- field: label above, hint below, error replaces the hint in the danger colour

### Motion

- durations: 150ms, 250ms, 400ms
- easing: cubic-bezier(0.2, 0.8, 0.2, 1)
- reduced motion: crossfade only, no movement

### Named rules

- **The Ledger Rule.** Money is set in tabular numerals, right-aligned, with the currency code.
- **The One Red Rule.** Red appears only for overdue and destructive actions, never for emphasis.

### Refusals

- side-stripe-border
- nested-cards
- kicker-above-heading
- gradient-text
- chip-soup
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