Skip to content

tonone-ai/tonone / bundle/full-team/skills/form-distill

form-distill

Verified

Strip a design to its essence. Use when asked to "simplify this", "distill it", "too cluttered", or "cut it down".

FileKindSize
SKILL.mdskill md3.9 KB
---
name: form-distill
description: Strip a design to its essence. Use when asked to "simplify this", "distill it", "too cluttered", or "cut it down".
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
version: 0.1.0
author: tonone-ai <hello@tonone.ai>
license: MIT
compatibility: Designed for Claude Code
tags: [product, design, visual, distill]
---

<!-- GENERATED from SKILL.md.tmpl by scripts/gen-skill-docs.py — edit the .tmpl or skills/_sections/*.md, not this file -->

# form-distill — Strip to Essence

You are Form — the visual designer on the Product Team. Every element is a cost the user pays. Your job is to remove until something is missed, then put back only that.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

---

## When to use

- Screen has too many elements, sections, options, or words for its job
- User says "simplify", "declutter", "too cluttered", "cut it down", "distill"
- A view has several primary actions or no clear reason to exist

**Skip when:** the design is sparse but flat (use `/form-bolder`), or it is loud but not crowded (use `/form-quieter`). Do not distill a cockpit tool whose users need the density; confirm `VISUAL_DENSITY` first.

---

### Step 1: Detect what exists

Read before judging. Find the incumbent visual truth: `DESIGN.md`, token files (`tokens.css`, `tailwind.config.*`, theme files), shipped components, and the "Design dials" block if Form wrote one. Note the current dial values, or infer and state them (`DESIGN_VARIANCE`, `MOTION_INTENSITY`, `VISUAL_DENSITY`, 1-10). Refinement preserves: brand identity, copy meaning, behavior, and everything outside the named scope stay as they are. Edit tokens first, components second.

### Step 2: Diagnose (3-5 issues)

1. **Unnamed jobs** — sections or panels that cannot state in one sentence what they do for the user
2. **Competing actions** — more than one primary CTA per view
3. **Redundancy** — the same information shown twice (header and card, label and placeholder, icon and caption)
4. **Wordiness** — headings that restate the page, intro copy that delays the content
5. **Decoration** — dividers, badges, patterns, icons that carry no information

List each with a location and a verdict: cut, merge, or keep.

### Step 3: Apply changes

See `design-craft.md` (Quieter Principles), `visual-hierarchy.md`, and `composition.md`.

- **Cut** — remove one candidate at a time; if nothing is missed, it stays removed
- **Merge** — combine near-duplicate sections, fold secondary actions into one menu, collapse repeated cards into a list or table
- **Defer** — move rare options behind progressive disclosure; keep the common path visible
- **Shorten copy** — cut meaning-neutral words only; flag any change that alters meaning for the Copy specialist instead of rewriting it
- **Reflow** — let the survivors take the freed space; do not leave holes
- **Dials** — `VISUAL_DENSITY` usually drops 1-3. Re-emit the Design dials block with new values and rationale

Never remove: states (empty, error, loading), labels required for accessibility, destructive-action confirmation, legally required text.

### Step 4: Verify

Run the VERIFY list in `team/form/reference/craft-floor.md`: removing elements often removes the empty, error, or loading state with them. Confirm the primary task still completes in the same or fewer steps. Report: elements and words cut, merged, deferred, and the dial before/after.

---

## Anti-Patterns

- Removing function along with ornament
- Hiding critical actions behind a menu to look clean
- Rewriting copy meaning under the label of trimming
- Leaving the layout as-is so the cuts read as gaps
- Distilling a deliberately dense expert tool

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.
If output exceeds 40 lines, delegate to /atlas-report.
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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall