Przejdź do treści
Biblioteka skilli
Bezpieczeństwo · Przegląd i audyt

finding-normalizer

/finding-normalizer

Zamienia surowe dowody z dokumentów, testów i skanów w stabilne wpisy ustaleń z identyfikatorami, wagą i statusem, łącząc duplikaty.

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
7
Skrypty
1
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ą
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/validate-findings.sh

Co robi i kiedy

Zamienia surowe dowody z dokumentów, testów i skanów w stabilne wpisy ustaleń z identyfikatorami, wagą i statusem, łącząc duplikaty.

Oryginalny opis (EN)

Turns mixed raw evidence from docs, tests, runtime checks and advisory feeds into stable finding entries with ids, severity, effort and status, deduplicating records of the same risk. Use when raw security or audit evidence must become report-ready findings JSON, or when findings or retest statuses need normalizing, validating or stable ids.

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 · 50 linii, 356 słów
Podgląd SKILL.md
---
name: finding-normalizer
description: Turns mixed raw evidence from docs, tests, runtime checks and advisory feeds into stable finding entries with ids, severity, effort and status, deduplicating records of the same risk. Use when raw security or audit evidence must become report-ready findings JSON, or when findings or retest statuses need normalizing, validating or stable ids.
metadata:
  model_tier: medium
  cacheable: 'false'
  output_format: json
  paqad-meta: skill.meta.yaml
---

## What It Does

Normalizes evidence from docs, tests, runtime checks, and advisory feeds into stable finding entries with consistent ids, severity, effort, and reproduction data.

Finding-id prefixes recognised by the normalizer are listed under `# code-prefix` in `assets/vocabulary.txt`:

- `PEN-*`: pentest findings (security workflow).
- `DT-*`: design-test findings (design-system audit workflow). Categories: `token | component | state | a11y | responsive | motion | copy | performance | documentation-drift`. `token` findings default to **high** severity to surface hard-coded design values (hex literals, raw px/rem, ad-hoc font stacks where a token exists).
- `SM-*`: site-map findings (site-map / site-map-retest workflow; `docs/site-map/<ts>.json`). The id is a content-addressed `SM-<hash8>`; the `SM-ADD | SM-REMOVE | SM-EDGE-STALE | SM-GUARD-DRIFT | SM-JOURNEY-BROKEN | …` names are `category` values, listed under `# site-map category` in `assets/vocabulary.txt`.
- `MD-*`: prospective module decisions. Stored under `.paqad/decisions/module-decisions/<id>.yml`; the consumer is the Attribution Gate, not the pentest workflow. Treat severity/effort/status as advisory only for `MD-*`, the binding state machine lives in `src/module-decisions/schema.ts`.

## Use This When

After raw security evidence has been collected and needs to be turned into report-ready findings or retest statuses.

## Inputs

- Read the structured evidence payload first.
- Read `references/finding-fields.md` before setting severity or effort.
- Read retest state when the workflow is `pentest-retest`.

## Procedure

1. Deduplicate findings that describe the same risk surface.
2. Pick severity, effort, and status from the closed sets in `assets/vocabulary.txt`.
3. Preserve ids and prior statuses when normalizing retest output.
4. Format the JSON exactly per `assets/output.template.json`.
5. Validate with `scripts/validate-findings.sh`: checks required fields, vocabulary, and id uniqueness.

## Output Contract

- Match `assets/output.template.json`: a JSON array of findings with `id, title, severity, effort, impact_area, evidence, reproduction, status` (plus optional `wstg_id` / `owasp_2025`).
- `severity`, `effort`, `status` must come from `assets/vocabulary.txt`.
- Output must pass `scripts/validate-findings.sh` (exit 0).

## Escalate / Stop Conditions

- Ask when two evidence records appear to describe overlapping but not identical risks.
- Warn when the available evidence is too thin to support the proposed severity.
- Do not inflate severity to compensate for missing detail.

## Resources

- `references/finding-fields.md`
- `scripts/validate-findings.sh`
- `assets/output.template.json`
- `assets/vocabulary.txt`
- `agents/openai.yaml`
Pliki w paczce (7)
  • SKILL.md 3 KB
  • skill.meta.yaml 1 KB
  • agents/openai.yaml 1 KB
  • assets/output.template.json 1 KB
  • assets/vocabulary.txt 2 KB
  • references/finding-fields.md 1 KB
  • scripts/validate-findings.sh 2 KB

Wersje

W bazie nie ma innych skilli o nazwie finding-normalizer.

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

  • 90ot-evidence-normalizer
    Zamienia wyniki analiz przemysłowych protokołów w ujednolicone zdarzenia i obserwacje procesu do rekonstrukcji incydentów.
  • 100finding-triage
    Ocenia pojedyncze ustalenie bezpieczeństwa ze skanera lub audytu, dobierając wagę, plan ograniczenia lub uzasadnienie fałszywego alarmu.
  • 90board-report
    Zamienia surowe dane bezpieczeństwa w zwięzły raport dla zarządu lub komitetu audytu, opisany językiem biznesu.
  • 100vuln-report
    Przygotowuje gotowe do ujawnienia zgłoszenie GitHub Security Advisory dla potwierdzonej podatności, z dowodami i wpływem.

Uwagi i zgłoszenia

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