writing-mappings SKILL.md skillA

writing-mappings from celigo/ai is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add celigo/ai/writing-mappings@git:20261017.e0e159f

Pins git:20261017.e0e159f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
celigo/ai
Path
skills/writing-mappings/SKILL.md
Versions recorded
4
Latest version
git:20261017.e0e159f, committed Oct 17, 2026
First version recorded
May 20, 2026
Size
22,939 bytes
Repository stars
4
License
MIT

Write field mappings and transforms in Celigo integrations. Covers Mapper 2.0 (imports), Transformation 2.0 (exports), lookups, response mapping, and Mapper 1.0 (NetSuite DA/Salesforce). Use when editing mappings[], transform{}, responseMapping, or lookup configurations.

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

<!-- TIER:1 -->

# Writing Mappings and Transforms

Mappings and transforms are the **data reshaping layer** in Celigo integrations. They control how fields from one system translate into fields for another. Mappings are used across flows, APIs, and tools.

## Mapping Systems

Four systems handle data reshaping:

- **Mapper 2.0** -- modern recursive field mapping on imports (`mappings[]` array). Handles nested objects, arrays of any depth, lookups, conditionals, and date conversions. Default for new imports on all adaptor types except NetSuite DA (`NetSuiteDistributedImport`) and Salesforce -- `NetSuiteHTTPImport` uses Mapper 2.0
- **Mapper 1.0** -- legacy flat mapping on Salesforce imports (`mapping.fields[]` / `mapping.lists[]`) and NetSuite DA imports (the same arrays under `netsuite_da.mapping`). Body-level and sublist fields in separate flat arrays. Also present on many older HTTP/FTP/RDBMS imports created before Mapper 2.0 existed
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add celigo/ai/writing-mappings@sha256:25448960b1102c6a

The line at the top of this page pins the label git:20261017.e0e159f, 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_pfevny5mviqicn4w.svg)](https://markdownregistry.com/a/art_pfevny5mviqicn4w)

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

Versions

The registry has recorded 4 versions of this file, between May 20, 2026 and Oct 17, 2026, about one every 50 days.

versioncommittedcommitsizeaudit
git:20261017.e0e159f latest2026-10-17 e0e159f 22,939 BA view · diff
git:20260904.b01b5882026-09-04 b01b588 21,910 BA view · diff
git:20260802.64e70c52026-08-02 64e70c5 20,100 BA view · diff
git:20260520.7414ff12026-05-20 7414ff1 19,280 BA 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 (22939 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

celigo/ai · 4 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pfevny5mviqicn4w
GET https://markdownregistry.com/api/v1/resolve?ref=celigo/ai/writing-mappings
GET https://markdownregistry.com/api/v1/blob/25448960b1102c6aee4437fe59af79782fb3f92318d6badc1fd9a62fb218994b

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 celigo/ai

building-apis SKILL.md skill
celigo/ai · skills/building-apis/SKILL.md · Build Celigo APIs -- custom HTTP endpoints that let external systems push or query data synchronously through Celigo…
git:20261017.e0e159f · audit A · 4 stars
building-b2b SKILL.md skill
celigo/ai · skills/building-b2b/SKILL.md · Build Celigo B2B Manager EDI integrations -- trading partner onboarding, EDI profiles, file definitions, X12/EDIFACT…
git:20261017.e0e159f · audit A · 4 stars
building-flows SKILL.md skill
celigo/ai · skills/building-flows/SKILL.md · Build Celigo flows -- pipelines that move data from source systems to destination systems on a schedule or in response…
git:20261017.fa65915 · audit A · 4 stars
building-mcp-servers SKILL.md skill
celigo/ai · skills/building-mcp-servers/SKILL.md · Build Celigo MCP server resources -- endpoints that expose Tools and builder-mode APIs to external AI agents and MCP…
git:20261017.e0e159f · audit A · 4 stars
building-tools SKILL.md skill
celigo/ai · skills/building-tools/SKILL.md · Build Celigo tool resources -- reusable building blocks that encapsulate lookups, imports, transforms, and branching…
git:20261017.e0e159f · audit A · 4 stars
configuring-ai-agents SKILL.md skill
celigo/ai · skills/configuring-ai-agents/SKILL.md · Configure Celigo AI agent and guardrail imports -- LLM-powered steps that classify, extract, validate, or generate data…
git:20261017.e0e159f · audit A · 4 stars
configuring-connections SKILL.md skill
celigo/ai · skills/configuring-connections/SKILL.md · Configure Celigo connections and iClients -- credential and configuration objects that authenticate to external…
git:20261017.e6de85a · audit A · 4 stars
configuring-exports SKILL.md skill
celigo/ai · skills/configuring-exports/SKILL.md · Configure Celigo export resources -- the data source step that fetches records from external systems. Use when creating…
git:20261017.e0e159f · audit A · 4 stars
configuring-filters SKILL.md skill
celigo/ai · skills/configuring-filters/SKILL.md · Configure Celigo filter rules on exports, imports, and flow branches that control which records continue through the…
git:20261017.e0e159f · audit A · 4 stars
configuring-guardrails SKILL.md skill
celigo/ai · skills/configuring-guardrails/SKILL.md · Configure Celigo guardrail resources -- safety and compliance checks that validate data flowing through integrations…
git:20261017.e0e159f · audit A · 4 stars
configuring-imports SKILL.md skill
celigo/ai · skills/configuring-imports/SKILL.md · Configure Celigo imports -- the destination step that writes records to external systems. Use when creating imports…
git:20261017.e6de85a · audit A · 4 stars
configuring-lookup-caches SKILL.md skill
celigo/ai · skills/configuring-lookup-caches/SKILL.md · Configure Celigo lookup cache resources -- in-memory key-value stores used for fast lookups, deduplication…
git:20261017.e6de85a · audit A · 4 stars

Every file in celigo/ai

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