optical-alignment-ui
/optical-alignment-ui
Diagnozuje optyczne wyrównanie w interfejsie: ikony wydają się przesunięte, okręgi wydają się mniejsze od kwadratów, a etykiety CAPS za duże.
- Autor
- vinimrdi ↗
- Repozytorium
- optical-alignment-ui ↗
- Licencja
- CC-BY-4.0
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 11
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
CC-BY-4.0, otwarta.
Co robi i kiedy
Diagnozuje optyczne wyrównanie w interfejsie: ikony wydają się przesunięte, okręgi wydają się mniejsze od kwadratów, a etykiety CAPS za duże.
Oryginalny opis (EN)
Optical alignment and optical adjustment for digital UI (precision vs perception). Use when icons look off-center, play buttons lean left, circles look smaller than squares, icon sets feel uneven, icon+label pairs misalign, ALL CAPS looks oversized, button labels sit wrong, or type needs overshoot / optical margin / font-optical-sizing. Apply evidence-based diagnosis, geometric vs perceptual centers, smallest effective correction, and design-system hand-off. Do not invent universal +2px rules, reduce touch targets, or treat centroid as absolute optical truth.
Jak działa
- Compatible agents
- Companion skill
- Scope and rigor
- Outcomes (mandatory)
- Severity and confidence (independent)
- Evidence-Based Optical Workflow
- Geometric decision matrix (summary)
- Reasoning rules
- When to activate / when not
- Analysis output format
Podgląd SKILL.md
--- name: optical-alignment-ui description: > Optical alignment and optical adjustment for digital UI (precision vs perception). Use when icons look off-center, play buttons lean left, circles look smaller than squares, icon sets feel uneven, icon+label pairs misalign, ALL CAPS looks oversized, button labels sit wrong, or type needs overshoot / optical margin / font-optical-sizing. Apply evidence-based diagnosis, geometric vs perceptual centers, smallest effective correction, and design-system hand-off. Do not invent universal +2px rules, reduce touch targets, or treat centroid as absolute optical truth. metadata: author: vinimrdi version: "1.5.3" language: en tags: optical-alignment, optical-adjustment, optical-centering, ui, ux, typography, icons, agent-skills, claude-code, cursor, lovable, pixel-perfect, visual-balance --- # Optical Alignment UI — Precision vs Perception **Agent skill** for making digital interfaces *look* balanced when mathematical alignment does not. Invoke as `/optical-alignment-ui` where supported, or attach this folder as context. Progressive disclosure: load [references/](references/) only when needed. Examples: [examples/](../../examples/). Tools: [scripts/](../../scripts/). ## Compatible agents See [docs/compatibility-and-integrations.md](../../docs/compatibility-and-integrations.md). ## Companion skill **[ux-laws-principles](https://github.com/vinimrdi/ux-laws-principles)** — task first; optical craft second. ## Scope and rigor | Kind | Examples | |------|----------| | **Heuristic / practice** | Play-icon nudge, caps size, icon+label | | **Platform guidance** | Keylines; platform icon notes | | **Type mechanics** | Overshoot, optical margin | | **Engineering aid** | Area scale, geometric/alpha centroid — **diagnostic only** | Optional measurement (diagnostic, not perceptual law): ```bash pip install -r scripts/requirements.txt # Raster with alpha python scripts/centroid.py path/to/icon.png --verbose # SVG at real UI size (needs cairo system libs for cairosvg) python scripts/svg_centroid.py path/to/icon.svg --size 24 -v # Smoke fixtures python scripts/centroid.py fixtures/play-24.png --json python scripts/svg_centroid.py fixtures/play.svg --size 24 --json ``` Prefer smallest effective correction. No universal pixel offsets. Re-check contrast and targets after changes. ## Outcomes (mandatory) | Outcome | When | |---------|------| | **Implement** | Evidence sufficient, low risk, a11y safe | | **Propose** | Plausible; needs human judgment | | **Abstain** | No imbalance, weak evidence, or wrong skill | ## Severity and confidence (independent) **Severity** 0–4 · **Confidence** High / Medium / Low / Unverified *Severity 3 + Confidence Low* → do not implement yet. ## Evidence-Based Optical Workflow 1. Context capture 2. Baseline at native size 3. Geometric analysis (box / centroid / alpha — optional `centroid.py` or `svg_centroid.py`) 4. Perceptual assessment 5. Diagnosis (intent, severity, confidence) 6. Minimal intervention (prefer pad-in-asset) 7. Visual validation 8. Design-system hand-off Details: [evidence-and-validation.md](references/evidence-and-validation.md) · [geometry-and-centroids.md](references/geometry-and-centroids.md) · [accessibility-and-constraints.md](references/accessibility-and-constraints.md) · [anti-patterns.md](references/anti-patterns.md) ## Geometric decision matrix (summary) | Problem | Prefer first | |---------|--------------| | Symmetric filled rect | Bounding-box center | | Filled play triangle | Centroid check + eye + pad-in-asset | | Outline icons | Stroke mass; not fill centroid alone | | Soft/raster edges | `centroid.py` / alpha weights | | SVG icons | `svg_centroid.py --size <ui-px>` | | Circle vs square size | **Name intent** | | Uneven icon set | Keylines + set review | | Bad viewBox | Fix asset first | ## Reasoning rules Visible imbalance first · Grid first · Shift against weight · Color last · Do not fight type overshoot · No one-offset for whole sets · Check anti-patterns · Explain while applying ## When to activate / when not **Activate:** off-center glyphs, asymmetric icons, circle/square scale, icon+label, uneven sets, caps, overshoot/`opsz`, AI UI optically wrong, asset hand-off. **Skip as primary:** a11y-only; no composition; illustration-only; universal +2px; physical optics. ## Analysis output format What observed · Evidence · Concept · What/Why/Who/Where/When/How · Intent · Impact · Severity · Confidence · **Outcome** · Trade-off · Validation · Hand-off ## Reference library - [Evidence](references/evidence-and-validation.md) · [Geometry](references/geometry-and-centroids.md) · [A11y](references/accessibility-and-constraints.md) - [Anti-patterns](references/anti-patterns.md) · [Platform](references/platform-behavior.md) - [Typography](references/typography.md) · [Shapes](references/shapes-and-icons.md) · [Color](references/color-and-components.md) · [Implementation](references/implementation.md) - [Formulas & sources](references/formulas-limits-sources.md) · [Examples](../../examples/) · [Scripts](../../scripts/) · [Fixtures](../../fixtures/) Version: [CHANGELOG.md](../../CHANGELOG.md) (**1.5.3**).
Pliki w paczce (11)
- SKILL.md 5 KB
- references/accessibility-and-constraints.md 2 KB
- references/anti-patterns.md 2 KB
- references/color-and-components.md 1 KB
- references/evidence-and-validation.md 2 KB
- references/formulas-limits-sources.md 3 KB
- references/geometry-and-centroids.md 3 KB
- references/implementation.md 1 KB
- references/platform-behavior.md 2 KB
- references/shapes-and-icons.md 2 KB
- references/typography.md 3 KB
Wersje
W bazie nie ma innych skilli o nazwie optical-alignment-ui.
Migawka bazy z 13.11.2026 · wersja paczki 50251eeee5d6 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100optical-centering
Sprawdza i koryguje optyczne centrowanie tekstu z ikonami i etykietami w UI, zanim trafi na produkcję. - 100icon-design
Projektuje i wdraża spójne systemy ikon SVG dla interfejsów: siatki keyline, reguły obrysu, korekty optyczne, style outline, filled i duotone, wyrównanie z tekstem, animacje i dostępny kod. - 95better-ui
Stosuje dokładne wartości dopracowania UI: współśrodkowy promień zaokrągleń, optyczne wyrównanie, warstwowe cienie, skalę 0,96 przy naciśnięciu, przenikanie ikon i wyłączanie przejść przy zmianie motywu. - 100ui
Przedstawia zasady design engineeringu dla dopracowanych interfejsów: animacje, stany hover, cienie, obramowania, typografia, optyczne wyrównanie i cyfry tabelaryczne. - 100better-ui
Dopracowuje detale interfejsu: animacje, stany najechania, cienie, obramowania, mikrointerakcje i ikony w kodzie frontendu. - 100make-interfaces-feel-better
Podaje 16 zasad inżynierii projektowej do dopracowania interfejsów: typografia, powierzchnie, animacje i wydajność, w tym promienie, cienie, animacje stagger, przejścia wejścia i wyjścia oraz wyrównanie optyczne.