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

design-system-coverage

/design-system-coverage

Ocenia kompletność kontraktu systemu projektowego i zapisuje spis pokrycia, z którego korzystają kolejne testy projektu.

Repozytorium
paqad-ai ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
10
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

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

Co sprawdzić przed instalacją
  • 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/count-clauses.sh, scripts/derive-tier.sh, scripts/gap-report.sh, scripts/list-contract-files.sh, scripts/validate-contract.sh

Co robi i kiedy

Ocenia kompletność kontraktu systemu projektowego i zapisuje spis pokrycia, z którego korzystają kolejne testy projektu.

Oryginalny opis (EN)

Grades the design-system contract for completeness and writes the coverage inventory every later design-test skill reads. Use when a design-test run starts; it always runs first and its tier gates the run.

Jak działa

  1. What It Does
  2. Use This When
  3. Inputs
  4. Procedure
  5. Output Contract
  6. Escalate / Stop Conditions
  7. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 439 słów
Podgląd SKILL.md
---
name: design-system-coverage
description: 'Grades the design-system contract for completeness and writes the coverage inventory every later design-test skill reads. Use when a design-test run starts; it always runs first and its tier gates the run.'
metadata:
  model_tier: reasoning
  cacheable: 'false'
  output_format: json
  paqad-meta: skill.meta.yaml
---

## What It Does

Grades `docs/instructions/design-system/` for completeness, produces a coverage inventory, and emits the **tier** (`missing | bare | adequate | strong`) the rest of the workflow uses to decide whether to stop, warn, or proceed in strict mode. Runs as Step 0 (readiness gate) and as the first skill in Step 1: every downstream skill consumes this inventory.

## Use This When

As the **first skill in every design-test run**. The tier it emits gates the entire workflow. Never skip it; never run other design-test skills without it.

## Inputs

- Read every file under `docs/instructions/design-system/` (typically `tokens.md`, `components.md`, `accessibility.md`, `motion.md`, `patterns.md`, `responsive.md`).
- Read `references/contract-clauses.md` before grading.

## Procedure

The decisions in steps 1–3 are deterministic: drive them with the scripts in
`scripts/` rather than re-deriving the logic from prose each run.

1. Run `scripts/list-contract-files.sh` to enumerate which contract files exist and which are empty/stub.
2. For each file, run `scripts/count-clauses.sh <file>` to count contract clauses (the file emits `<path>\t<count>` and skips headings, blank lines, frontmatter delimiters, and lines inside fenced code blocks). Concatenate the rows.
3. Pipe the concatenated counts into `scripts/derive-tier.sh`: it emits a single `tier=<missing|bare|adequate|strong>` line. This is the gate decision: don't second-guess it.
4. Emit the coverage inventory per `assets/output.template.json` to `.paqad/design-test/runs/<run_id>/artifacts/contract-summary.json`.
5. Validate with `scripts/validate-contract.sh`: enforces required fields, allowed tier vocabulary, and rejects empty clause arrays when the tier is `adequate` or `strong`.
6. If tier is `missing`, raise a Decision Pause Contract packet asking the user whether to invoke the `documentation-update` workflow inline for `design-system` before resuming. If tier is `bare`, additionally run `scripts/gap-report.sh` and emit each row as a `DT-DS-XXXX` `documentation-drift` finding (the script's id sequence is stable across runs so retests preserve ids).

## Output Contract

- Match `assets/output.template.json`: `{ tier, files: [{ path, present, empty, clause_count }], clauses: { tokens: [...], components: [...], accessibility: [...], responsive: [...], motion: [...], patterns: [...] } }`.
- `tier` ∈ `missing | bare | adequate | strong`.
- Output must pass `scripts/validate-contract.sh` (exit 0).

## Escalate / Stop Conditions

- Stop and prompt when tier is `missing`. Offer inline invocation of the `documentation-update` workflow for the design-system.
- Warn when tier is `bare`. Run downstream skills in exploratory mode and tag findings `confidence: low`.
- Do not auto-engage `design_test.strict` when tier is `strong`: strict mode is explicit opt-in only.

## Resources

- `references/contract-clauses.md`
- `scripts/list-contract-files.sh`: enumerate contract files (present/empty/non-empty).
- `scripts/count-clauses.sh`: count clauses in one contract file.
- `scripts/derive-tier.sh`: derive the tier from per-file counts (pure function of counts).
- `scripts/gap-report.sh`: enumerate contract gaps as `DT-DS-XXXX` rows with stable ids.
- `scripts/validate-contract.sh`: schema-check the emitted coverage inventory.
- `assets/output.template.json`
- `agents/openai.yaml`
Pliki w paczce (10)
  • SKILL.md 4 KB
  • skill.meta.yaml 1 KB
  • agents/openai.yaml 1 KB
  • assets/output.template.json 1 KB
  • references/contract-clauses.md 3 KB
  • scripts/count-clauses.sh 1 KB
  • scripts/derive-tier.sh 2 KB
  • scripts/gap-report.sh 1 KB
  • scripts/list-contract-files.sh 1 KB
  • scripts/validate-contract.sh 1 KB

Wersje

W bazie nie ma innych skilli o nazwie design-system-coverage.

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

  • 90validate-design-contract
    Testuje projekt kontraktu projektowego przed budową: uprawnienia, kompletność, sprzeczności, stany, dostępność i testowalność.
  • 90ds-pr-review
    Przegląda pull request z interfejsem pod kątem zasad systemu projektowego i zapisuje jeden komentarz pogrupowany według wagi.
  • 90design-review
    Ocenia zmianę interfejsu pod kątem UX, jakości wizualnej i użycia systemu projektowego na podstawie zrzutów ekranu.
  • 100design-test
    Sprawdza działający interfejs względem kontraktu systemu designu, uruchamiając pomocnicze narzędzia i zapisując raport z plikiem JSON.
  • 100hig-project-context
    Tworzy lub aktualizuje wspólny dokument kontekstu projektowego Apple, z którego korzystają inne skille HIG, aby dopasować wskazówki do projektu.
  • 100start
    Uruchamia lub wznawia projekt systemu projektowego w repozytorium: wykrywa stos, zadaje pytania i prowadzi dalsze kroki.

Uwagi i zgłoszenia

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