SkillVaultskills Browse all 500 skills

Data · Version 1.4.0 · Reviewed 2026-08-02

Metric Definition Governance Advisor

Make data systems more correct and operable for definition ownership and semantic layer design with evidence, explicit trade-offs, and a verification plan.

4 method steps 4 documented failure modes 4 diagnostic checks 7 quality gates

Establishes single authoritative metric definitions and the process that keeps them from forking again.

₹99 one-time

Get this skill archive

What this skill helps you do

  • Definition ownership
  • Semantic layer design
  • Change control

How Metric Definition Governance Advisor works

You provide

Schema, volumes, and the queries that actually run

It inspects

Access patterns and skew affecting definition ownership

It decides

A semantic layer design design with migration ordering

You verify

Row counts and checksums compared before cutover

What it checks first

Metric Definition Governance Advisor establishes single authoritative metric definitions and the process that keeps them from forking again. Use it when the work involves Definition ownership, Semantic layer design, Change control.

  1. The real access patterns, since schema quality is meaningless without the queries it serves.
  2. Cardinality, skew, and growth rate of the key columns.
  3. Consistency and freshness requirements per consumer.
  4. Whether the model preserves history or overwrites it, which determines what questions remain answerable.

Failure modes it recognizes

  • A schema optimized for writes that makes the dominant read pattern a full scan.
  • Skewed partitioning concentrating load on one node.
  • Nullable columns encoding several meanings, making every downstream query ambiguous.
  • A pipeline silently dropping late-arriving records and under-reporting totals.

Answers it will reject

  • Normalizing or denormalizing by preference rather than by measured access pattern.
  • Adding a column for each new requirement until the table encodes multiple entities.
  • Backfilling without a reconciliation check that proves completeness.

Decision rules it applies

  • Design from the read path backward for read-heavy systems.
  • Make invalid states unrepresentable with constraints rather than conventions.
  • Version the schema and treat consumer compatibility as a contract.

Evidence it asks for

  • Profile real query patterns and volumes before proposing a change.
  • Validate migrations with row counts, checksums, and spot comparisons.
  • Monitor freshness and completeness as first-class data-quality signals.

The method inside

  1. Map the artifact, actors, boundaries, and invariants relevant to definition ownership.
  2. Trace concrete failure or abuse paths for semantic layer design; do not report checklist items without a mechanism.
  3. Prioritize change control findings by impact, likelihood, confidence, and cost of correction.
  4. Recommend the smallest defensible change, then define how an independent reviewer can verify it.

Deliverables

  • Definition ownership assessment
  • Semantic layer design decision and action plan
  • Change control verification checklist

Evidence requirements

  • Schema, access patterns, query plans, or event contracts
  • Volume, cardinality, retention, and freshness
  • Consistency, latency, and migration constraints

Quality gates

  • Every material claim traces to supplied evidence or is labeled as a hypothesis.
  • The response follows the declared deliverable contract.
  • No execution, access, measurement, or verification is invented.
  • Secrets and personal data are redacted rather than repeated.
  • The user receives a concrete independent verification step.
  • The relevant failure modes in this domain were considered rather than only the reported symptom.
  • No listed anti-pattern was recommended as a solution.

Example task

Input

Finance and product report different active user numbers and both insist their definition is correct.

Expected output

Both are probably right about their own definition, which is the actual problem. Write both definitions down explicitly, decide which question each answers, then implement them once in a semantic layer so a dashboard cannot silently invent a third...

Boundaries and compatibility

Ideal for

  • Definition ownership: produce a decision or artifact grounded in supplied evidence.
  • Semantic layer design: produce a decision or artifact grounded in supplied evidence.
  • Change control: produce a decision or artifact grounded in supplied evidence.

Out of scope

  • Recommending indexes without a workload
  • Treating eventual consistency as universally acceptable

Agent compatibility

  • GitHub Copilot custom agents
  • Claude Agent Skills / SKILL.md
  • Any instruction-following chat model

Tool policy: Advisory by default. No tools are assumed. If the host provides tools, use read-only evidence gathering unless the user explicitly approves a scoped write or execution action.