Przejdź do treści
Biblioteka skilli
Dane i analityka · Planowanie

data-contracts

/data-contracts

Uzgadnia, wersjonuje i egzekwuje kontrakty na zbiory danych używane przez inne zespoły, modele lub pulpity.

Repozytorium
skills ↗
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
5
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/contract_diff.py

Co robi i kiedy

Uzgadnia, wersjonuje i egzekwuje kontrakty na zbiory danych używane przez inne zespoły, modele lub pulpity.

Oryginalny opis (EN)

Use when a dataset is consumed by another team, model, dashboard or agent and its schema, grain, keys, freshness or semantics must be agreed, versioned and enforced, or when a producer wants to change such a dataset.

Jak działa

  1. Invariants
  2. Flow
  3. Routes
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 387 słów
Podgląd SKILL.md
---
name: data-contracts
description: "Use when a dataset is consumed by another team, model, dashboard or agent and its schema, grain, keys, freshness or semantics must be agreed, versioned and enforced, or when a producer wants to change such a dataset."
---

# Data contracts

A contract is the explicit promise a producer makes to consumers: what the dataset is,
at what grain, with which columns and types, how fresh, and what the values mean. It
turns "don't break my dashboard" into something a machine checks.

## Invariants

- Contract the boundaries, not every model: sources you ingest from, and marts or exports others consume.
- A contract states: owner, purpose, grain and primary key, columns with types/nullability/meaning, freshness SLA, allowed values or ranges for critical columns, version.
- The contract lives in the repo next to the model (YAML), versioned and reviewed like code.
- Enforce it in the build: schema enforcement (e.g. dbt model contracts) plus tests for keys, ranges and freshness (skill `data-quality-gates`); a broken contract blocks.
- Additive changes (new nullable column) are minor; removing/renaming a column, changing type, grain or meaning is breaking.
- Breaking changes ship as a new version with a deprecation window; the old version keeps working until consumers migrate.
- Semantics count as much as schema: a column whose meaning changes is a breaking change even if its type does not.
- Do not contract what you do not understand yet; profile the source first and start with a light contract (expected columns + PK), then tighten.
- Consumers are listed (dbt exposures or a consumers section) so impact is known before a change.
- Metric meaning and status live in the `metric-card` skill (data-analysis plugin). A contract may name the metrics a dataset feeds; it does not redefine them. Publishing gates that read the card are in `data-quality-gates`.

## Flow

1. Identify the boundary and its consumers.
2. Draft the contract from `references/contract-template.yaml`.
3. Agree with consumers on grain, keys, freshness and meaning of critical columns.
4. Enforce: model contract and tests in CI; freshness before builds.
5. Change: classify additive vs breaking with `scripts/contract_diff.py`; breaking means a new version.

## Routes

Read only the reference for the task.

| If the task is... | Read |
|-------------------|------|
| Writing a contract file | `references/contract-template.yaml` |
| Enforcing in dbt (contract enforced, constraints, versions, exposures) | `references/dbt-contracts.md` |
| Contracts on ingested sources (expected columns, schema drift handling) | `references/source-contracts.md` |
| Classifying a schema change as additive or breaking | `scripts/contract_diff.py` (requires PyYAML, outside the standard library) |
Pliki w paczce (5)
  • SKILL.md 3 KB
  • references/contract-template.yaml 1 KB
  • references/dbt-contracts.md 1 KB
  • references/source-contracts.md 1 KB
  • scripts/contract_diff.py 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · afonsoalrocha/skills90MIT
sallaumen/elixir-agent-kit100MIT

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

  • 100designing-data-contracts
    Definiuje i egzekwuje kontrakty danych między producentami i konsumentami: schemat, semantykę, właściciela, SLA i wersjonowanie, by zmiany w źródle nie psuły potoków.
  • 100design-data-contracts-and-tests
    Wyprowadza kontrakt danych na granicy producenta (schemat, semantyka, świeżość, wolumen, właściciel) i zestaw testów walidacyjnych z poziomami ważności.
  • 90data-data-contracts
    Definiuje kontrakty danych między producentami i konsumentami, z wersjonowaniem, testami w CI i konfiguracją dbt.
  • 100odcs-contracts
    Pisze i waliduje kontrakty danych w standardzie ODCS v3.2.0 i pilnuje, by modele dbt zgadzały się z kontraktem.
  • 100data-contract
    Definiuje kontrakt danych dla tabeli używanej przez innych: schemat, klucze, dozwolone wartości, świeżość i właściciela oraz generuje testy.
  • 100data-designer
    Generuje syntetyczne zbiory danych i buduje potok ich tworzenia na podstawie opisu zbioru podanego przez użytkownika.

Uwagi i zgłoszenia

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