From harness-claude
Applies Gestalt closure (completing shapes) and continuity (smooth paths) principles for designing recognizable icons, progress indicators, charts, and visual UI flows.
npx claudepluginhub intense-visions/harness-engineering --plugin harness-claudeThis skill uses the workspace's default tool permissions.
> Pattern completion — the brain fills gaps in incomplete shapes (closure) and follows smooth paths over abrupt changes (continuity), with implications for icons, progress indicators, and visual flow
Guides icon design with pixel grid alignment, stroke weight consistency, optical sizing, metaphor clarity, icon families, and filled vs outlined states. Use for building, auditing, or selecting UI icon sets.
Designs scalable UI icons using grid systems, optical alignment, stroke consistency, metaphor selection, and SVG optimization for coherent icon sets.
Provides practical UI design patterns and principles from Refactoring UI and Practical UI for layout, spacing, typography, color, hierarchy, and styling in web projects.
Share bugs, ideas, or general feedback.
Pattern completion — the brain fills gaps in incomplete shapes (closure) and follows smooth paths over abrupt changes (continuity), with implications for icons, progress indicators, and visual flow
Understand closure. The Gestalt principle of closure states that the brain automatically completes incomplete shapes, perceiving whole forms from partial information. A circle with a gap is still perceived as a circle. A square missing a corner is still perceived as a square. This principle is foundational to icon design — icons work because the brain fills in detail that pixels cannot provide at small sizes.
Critical implication: Closure means you can remove visual information without losing meaning, as long as enough structural cues remain. This is the basis of minimalist design — show less, mean the same.
Apply closure to icon design. Icons are closure in action. At 24x24px or 16x16px, there is insufficient resolution for photorealistic representation. Icons succeed by providing just enough visual structure for the brain to complete the pattern.
Worked example — Apple's SF Symbols:
Decision procedure for icon simplification:
Apply closure to progress indicators. Progress rings, step indicators, and loading animations all exploit closure. An incomplete ring is perceived as "a ring that is partially filled" rather than "an arc" — the brain supplies the complete circle and interprets the gap as "remaining."
Worked example — circular progress indicators (Material Design):
rgba(0,0,0,0.08) on light backgrounds, rgba(255,255,255,0.12) on dark — visible enough to complete the shape, faint enough not to compete with the filled portionWorked example — step indicators (Stripe onboarding):
Understand continuity. The Gestalt principle of continuity states that the eye follows smooth, continuous paths over abrupt direction changes. When two lines cross, the brain perceives two straight lines passing through each other rather than four lines meeting at a point. The eye prefers the interpretation that maintains smooth trajectory.
Critical implication: Continuity governs how users scan a page. The eye follows alignment axes, baselines, and directional cues. If elements are arranged along a smooth path, the eye will follow that path. If the path has a sharp break, the eye stops or gets confused.
Apply continuity to layout flow. Continuity dictates that content should follow predictable reading paths. In Western interfaces, the primary axis is top-to-bottom, left-to-right (Z-pattern or F-pattern).
Worked example — Stripe's marketing page flow:
Worked example — dashboard data flow:
Apply continuity to data visualization. Line charts, flow diagrams, and Sankey charts depend entirely on continuity. The eye follows the line, interpreting it as a single continuous data stream.
Worked example — GitHub contribution graph:
Decision procedure for visual flow:
Not all shapes tolerate the same degree of incompleteness. Recognition depends on the object's gestalt strength — how strong its internal structure is:
Implication for icon design: Use geometrically simple base shapes (circles, squares, triangles) as the foundation. These tolerate more simplification and reproduce cleanly at all sizes.
Breadcrumbs exploit continuity. The chain Home > Products > Shoes > Running creates a left-to-right continuity line that the eye follows. The separator characters (>, /, arrows) serve as continuity connectors — they tell the brain "this is one path, read it as a sequence."
> or chevron-right icon — implies direction and flow/ — implies hierarchy but not directionTimelines exploit vertical continuity. A connecting line between events creates an unambiguous time-flow axis:
Skeleton screens exploit closure. A gray rectangle where a text block will appear triggers closure — the brain completes the pattern: "this is text that has not loaded yet." The skeleton must match the structural layout of the real content closely enough for the brain to complete the prediction.
Worked example — Facebook/Meta skeleton screens:
Broken closure targets in progress indicators. A progress ring without a track (just an arc floating in space). The brain cannot determine the total — is this 75% of a circle or just a curved line? Always provide the complete shape as a track, scaffold, or background so the brain knows what is being "filled." Material Design specifies both determinate (with track) and indeterminate (animated arc) variants — the indeterminate variant uses continuous animation to signal "in progress" since static closure cues would mislead.
Jagged continuity in layouts. Elements at inconsistent left margins — a heading at 24px, a paragraph at 32px, a list at 40px, then back to 24px. Each shift breaks the vertical continuity line and forces the eye to re-orient. The fix is a grid: define column edges and snap every element to one. Stripe's marketing pages use exactly three alignment points: left column edge, center, and right column edge. Nothing falls between.
False continuity between unrelated sequences. A connecting line between steps that are not sequential, or breadcrumbs that show a path the user did not actually take. Continuity creates a powerful narrative implication — "these are connected in order." Using continuity connectors between unrelated items misleads users into seeing a false sequence. Shopping sites that show Home > Sale > Product when the user arrived from a search (not through the Sale page) create false continuity.
Over-simplified icons (below closure threshold). Reducing an icon until it loses its essential geometric cues. A "settings gear" icon simplified to a plain circle has crossed the closure threshold — the brain cannot complete "gear" from a circle alone. Test icons at their smallest rendered size (typically 16px) and verify recognition without labels.
Apple SF Symbols — Closure Mastery:
Material Design Step Indicators — Closure + Continuity Combined:
Spotify's Progress Bar:
GitHub Contribution Graph — Continuity in Data: