Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Analiza

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.

Licencja
CC-BY-4.0
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
11
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Compatible agents
  2. Companion skill
  3. Scope and rigor
  4. Outcomes (mandatory)
  5. Severity and confidence (independent)
  6. Evidence-Based Optical Workflow
  7. Geometric decision matrix (summary)
  8. Reasoning rules
  9. When to activate / when not
  10. Analysis output format
Sekcje z nagłówków SKILL.md, w oryginale · 104 linii, 509 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.