Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

quality-loop

/quality-loop

Prowadzi pętlę poprawek interfejsu, aż bramki jakości przejdą: ocena, testy, audyt i naprawa kolejnych uwag.

Licencja
MIT
Ostatnia zmiana repozytorium
18.09.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi pętlę poprawek interfejsu, aż bramki jakości przejdą: ocena, testy, audyt i naprawa kolejnych uwag.

Wyzwalacze z opisu

rapihin sampai bagusrapihin detailrapikan kode
Oryginalny opis (EN)

Loop UI work until quality gates pass — judge/build, test, audit, fix, repeat. Use for “rapihin sampai bagus”, polish until audit passes, fix Critical/High design findings, or /polish. Do not use for one-shot “rapihin detail”, copy-only rewrites, or “rapikan kode”.

Jak działa

  1. Overview
  2. When to use
  3. When to skip
  4. Agents (orchestrate — do not nest personas forever)
  5. Gates (pass / fail)
  6. Iteration cap
  7. Workflow
  8. Output template (every cycle)
  9. Final output (DONE or STOP)
  10. Checklist
Sekcje z nagłówków SKILL.md, w oryginale · 141 linii, 971 słów
Podgląd SKILL.md
---
name: quality-loop
description: >-
  Loop UI work until quality gates pass — judge/build, test, audit, fix, repeat.
  Use for “rapihin sampai bagus”, polish until audit passes, fix Critical/High
  design findings, or /polish. Do not use for one-shot “rapihin detail”, copy-only
  rewrites, or “rapikan kode”.
---

# UI Quality Loop

## Overview

Run a **tight quality loop** until the UI clears gates (or hit the iteration cap). This is the pack’s mini lifecycle — not full `/spec`→`/ship`, but **build → prove → audit → fix** until it’s good.

```text
JUDGE* → BUILD → TEST → AUDIT ──Critical/High──▶ FIX ──▶ TEST → AUDIT …
                         │
                       PASS → DONE
```

\* Judgment only on blank-canvas / first pass (see `design-direction` skip rules).

## When to use

- User asks “rapihin sampai bagus”, “sampai lulus audit”, keep iterating until gates pass
- `/polish` or natural language equivalent of the loop
- After a `/design`/`/audit` with Critical/High findings and user wants them cleared

## When to skip

- “Rapihin detail” / feels off → `polish` (one pass)
- Copy / “tulisan AI” → `content-design`
- “Rapikan kode” → `anti-slop-code`
- Single-line token tweak with no quality ask
- Pure audit with no fix permission (“audit saja”)
- User said stop / “cukup” / accepted remaining Medium/Low

## Agents (orchestrate — do not nest personas forever)

| Step | Agent |
|------|--------|
| Judgment + build + fix | `ui-developer` |
| Test | `test-engineer` |
| Audit | `design-reviewer` |

You (the session agent) are the **loop controller**. Personas do not call each other; you invoke their workflows in sequence.

## Gates (pass / fail)

| Gate | Pass when |
|------|-----------|
| **Anti-slop** | No Critical/High AI-aesthetic findings |
| **UI feel** | No Critical/High craft issues on touched UI (concentric radius, hit overlap, `transition: all`, broken press/enter) |
| **Control geometry** | radius follows project tokens; text/icon variants are optically balanced; pending/disabled/focus states do not shift geometry |
| **Tokens** | No Critical/High raw-hex / off-token issues; greenfield pack preset used decision tree + Token score / `(explicit)` / `(hard-gate)` / project system in Conventions check |
| **Responsive** | Conventions Responsive line present; full-width primary CTA <768; no Critical/High desktop-only layout on greenfield (320–1440) |
| **Hierarchy** | Hierarchy pass (one primary focus + one primary CTA) or waiver for tiny tweaks |
| **Typography** | One h1/page + sequential ladder (or waiver) |
| **Motion** | Shell light defaults **or** named families/patterns from `motion-families.md`; no decorative spam; reduced-motion; hand-roll (not registry default) |
| **Shell** | Theme in topbar; avatar → account menu; custom selects (or waivers) on dashboards |
| **Landing** | Marketing section stack via `marketing` (not hero-only; hand-roll) — or `n/a` for app-shell-only |
| **A11y** | No Critical keyboard/label/contrast findings (potential or measured) |
| **States** | Loading/error/empty handled for interactive surfaces touched |
| **Tests** | Planned critical cases green, or **explicit waiver** if no test runner / out of scope (document why) |
| **Perf (soft)** | No Critical obvious LCP/CLS footguns in touched UI; else note as remaining |

**Loop continues** while any **Critical** or **High** remains on touched UI.
**Medium/Low** do not block DONE unless the user asked for zero findings.

Do **not** invent a test stack just to satisfy the Tests gate — waive and list residual risk.

## Iteration cap

- Default **max 3** full AUDIT→FIX cycles after the first build
- On cap: stop, ship best effort, list remaining findings + what would need another round
- Never infinite-loop

## Workflow

### Round 0 — Direction + build

1. Load `design-direction` if non-trivial / blank-canvas
2. After direction: (+ `prototype` if comparing/stressing) → `tokens` → (+ `marketing` if landing) → (+ `app-shell` / `data-fetching` / `forms` if needed) → `components` → (+ `design-surfaces` when radius/control geometry is implicated) → **`anti-slop-code`** → **`responsive`** → **`motion`** (light shell; marketing = families/patterns from `motion-families.md`, hand-roll) → `anti-slop-design` → `polish` → `accessibility` (+ `webgl` / `seo` if needed)
3. Produce UI + **Conventions check** (`references/compliance-gates.md`)

### Each cycle — Prove + audit + fix

1. **TEST** — `testing` via `test-engineer` (/test-ui workflow) for touched surfaces
2. **AUDIT** — `design-reviewer` scorecard (/design or /audit). Mark unevaluated honestly.
3. **DECIDE**
   - All Critical/High clear → **DONE** (report scorecard + remaining Medium/Low)
   - Else if iterations left → **FIX** with `ui-developer` (only findings that block gates; include `design-surfaces` when radius is implicated)
   - Else → **STOP** at cap with remaining list

### Fix discipline

- Fix highest severity first
- Prefer token/system fixes over one-off hacks
- Re-run TEST for behavior you changed
- Do not expand scope to unrelated pages

## Output template (every cycle)

```markdown
## Quality loop — cycle N/3

### Test
- … pass/fail …

### Audit scorecard
| Metric | Status | Notes |
|--------|--------|-------|
| … | … | … |

### Blocking (Critical/High)
1. …

### Action
FIX … | DONE | STOP (cap)
```

## Final output (DONE or STOP)

1. What shipped / changed
2. Final scorecard
3. Remaining Medium/Low (if any)
4. Cycles used

## Checklist

- [ ] Judgment only when blank-canvas / first pass (skip rules honored)
- [ ] Build chain includes **responsive** + **motion** (+ **marketing** if landing) or waivers
- [ ] Gates table evaluated each cycle (Anti-slop, Feel, Tokens, Responsive, Hierarchy, Typography, Motion, Shell, Landing, A11y, States, Tests)
- [ ] Shell chrome: theme topbar + avatar menu + custom selects (or waivers)
- [ ] Marketing landing: section stack hand-roll (or n/a / waiver)
- [ ] Conventions check filled before DONE
- [ ] Control geometry Conventions line covers radius token, text/icon optical balance, and relevant states (or valid n/a/waiver)
- [ ] Cap ≤3 fix cycles; STOP lists remaining Critical/High if any
- [ ] No fabricated audit scores

## Depth

- Lifecycle A→Z: `references/fe-lifecycle.md`
- Judgment: `design-direction`
- Build: `tokens`, `components`, `design-surfaces` when radius is implicated, **`anti-slop-code`**, **`responsive`**, **`motion`** (`motion-families.md`), `anti-slop-design`, `polish`, `accessibility`
- Test: `testing` (+ `devtools` when measuring)
- Audit: `design-reviewer` + `references/anti-patterns.md` / `references/polish.md` / a11y / performance as needed

Wersje

RepozytoriumWynikLicencja
Ta strona · sukirman1901/frontend-expert100MIT
trpc-group/trpc-agent-go100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki ce20d8bc371f (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

  • 100visual-polish-loop
    Prowadzi rekurencyjną pętlę dopracowania wizualnego interfejsu: audyt stron, prototypy kierunków, wdrożenie i recenzje aż do czystego wyniku.
  • 100judge
    Bramkuje jakość projektu przed zgłoszeniem ukończenia: ocenia go według osi i scorecardu, a po nieudanym przeglądzie prowadzi pętlę poprawek.
  • 90design-audit
    Przeprowadza systematyczny audyt wizualny UI i UX oraz tworzy fazowe plany projektowe i krótkie przebiegi poprawek.
  • 100design-polish
    Przeprowadza końcowy przegląd jakości przed wydaniem i poprawia wyrównanie, odstępy, spójność, stany interakcji oraz mikrodetale interfejsu.
  • 100polish
    Dopracowuje drobne detale UI: wyrównanie optyczne, cyfry tabelaryczne, przejścia, stany naciśnięcia i obszary kliknięcia.
  • 100gauntlet-loop-max
    Prowadzi dwubramkową pętlę jakości dla pracy, której testy nie wystarczą: interfejsu, animacji, stron, tekstów i prezentacji.

Uwagi i zgłoszenia

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