transform SKILL.md skillA

transform from exmergo/dex is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add exmergo/dex/transform@git:20261019.afd1dcf

Pins git:20261019.afd1dcf in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
exmergo/dex
Path
skills/transform/SKILL.md
Versions recorded
21
Latest version
git:20261019.afd1dcf, committed Oct 19, 2026
First version recorded
Sep 1, 2026
Size
16,614 bytes
Repository stars
88
License
Apache-2.0

Use this to author and change a dbt project or a semantic layer: bootstrap a project (`transform init`), write or refactor models from staging to marts, add tests and docs, and define semantic models, entities, dimensions, and metrics in MetricFlow, Apache Ossie or SLayer YAML. Reach for it instead of editing model files by hand whenever a change spans more than one file or must stay consistent with the project: it validates the edit against the real schema, returns a reviewable diff with a…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Transform

Author and refactor the dbt project, both the SQL (staging to marts, tests,
docs) and the semantic layer on top. You write the file content; the engine
validates it, computes the diffs, and stores a plan. Nothing reaches the project
until `transform apply`, and any build runs against a dev target only.

<!-- dex:procedure:begin -->
## Procedure

dex works in one loop: explore, transform, maintain. Every step runs one engine
command, reads the single JSON envelope it prints, and decides the next step
from that envelope.

1. **Explore before you write.** Before writing or fixing SQL against a table
   whose columns, types, grain, or join keys you have not verified in this
   session, run `explore map` (or `explore profile <tables>` for a few named
   ones) and read its grain, keys, PII flags, and data-quality findings. Answer
   ad-hoc questions with `explore query`, never with a raw database client.
2. **Plan the change.** Author the file content and hand it to `transform plan`
   (or `semantic define|update|plan` for the semantic layer). Nothing is written
   yet. Read the diffs, the `warnings`, and, on a model that already exists,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add exmergo/dex/transform@sha256:d9f48a181b9c2ce6

The line at the top of this page pins the label git:20261019.afd1dcf, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_e7tvanfuuaq3kkoj.svg)](https://markdownregistry.com/a/art_e7tvanfuuaq3kkoj)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 21 versions of this file, between Sep 1, 2026 and Oct 19, 2026, about one every 2 days. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
git:20261019.afd1dcf latest2026-10-19 afd1dcf 16,614 BA view · diff
git:20261018.7b1c7bc2026-10-18 7b1c7bc 16,565 BA view · diff
git:20261016.de16d0d2026-10-16 de16d0d 15,768 BA view · diff
git:20261016.efcffb92026-10-16 efcffb9 15,960 BA view · diff
git:20261016.d241ff12026-10-16 d241ff1 14,872 BA view · diff
git:20261014.e918bad2026-10-14 e918bad 14,807 BA view · diff
git:20261012.7f9a0ba2026-10-12 7f9a0ba 14,962 BA view · diff
git:20261012.32132242026-10-12 3213224 14,966 BA view · diff
git:20261011.8dd6aa22026-10-11 8dd6aa2 14,709 BA view · diff
git:20261008.fe4d80c2026-10-08 fe4d80c 14,649 BB view · diff
git:20261008.49fc23d2026-10-08 49fc23d 14,642 BB view · diff
git:20261006.377191f2026-10-06 377191f 39,211 BB view · diff
git:20260916.898c8182026-09-16 898c818 38,451 BB view · diff
git:20260916.6cb51172026-09-16 6cb5117 38,253 BB view · diff
git:20260908.277fe262026-09-08 277fe26 36,192 BB view · diff
git:20260906.9a46d772026-09-06 9a46d77 34,260 BB view · diff
git:20260905.70455952026-09-05 7045595 31,391 BB view · diff
git:20260903.dbc25ec2026-09-03 dbc25ec 30,402 BB view · diff
git:20260902.bfe286a2026-09-02 bfe286a 29,175 BB view · diff
git:20260902.a3efc922026-09-02 a3efc92 28,704 BB view · diff
git:20260901.3687a822026-09-01 3687a82 27,678 BB view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16614 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

exmergo/dex · 88 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_e7tvanfuuaq3kkoj
GET https://markdownregistry.com/api/v1/resolve?ref=exmergo/dex/transform
GET https://markdownregistry.com/api/v1/blob/d9f48a181b9c2ce6ef2b3a6bed1e457a19edc639e07464c85c37367f163dd1ff

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from exmergo/dex

dex Cursor rule
exmergo/dex · .cursor/rules/dex.mdc · Drive the dex analytics-engineering engine via its command contract
git:20260626.ae43ecc · audit A · 88 stars
AGENTS.md AGENTS.md file
exmergo/dex · AGENTS.md
git:20261019.afd1dcf · audit A · 88 stars
explore SKILL.md skill
exmergo/dex · skills/explore/SKILL.md · Use this whenever you need to know what is actually in a database, warehouse, or DuckDB file before you trust it…
git:20261019.d2d852a · audit A · 88 stars
maintain SKILL.md skill
exmergo/dex · skills/maintain/SKILL.md · Use this to find out whether an existing dbt project or semantic layer (dbt, Ossie or SLayer) is correct against its…
git:20261019.afd1dcf · audit A · 88 stars

Every file in exmergo/dex

Browse by kind, by grade A, or by owner.