How do I install the Airtable Schema Diff skill?

Run npx skillmds@latest add mickzijdel/airtable-schema-diff in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Airtable Schema Diff skill do?

Compare two Airtable schema exports to see what changed between them. Use when the user wants to diff two schema JSON files, detect table/field/view additions, removals, renames, or type changes. It is listed under Coding & Dev Tools on SkillMD.

Is Airtable Schema Diff safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Airtable Schema Diff?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Airtable Schema Diff free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Airtable Schema Diff?

mickzijdel (@mickzijdel) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Airtable Schema Diff by mickzijdel — Agent Skill

Name: Airtable Schema Diff
Author: mickzijdel

File contents

Airtable Schema Diff Skill

Purpose

This skill covers running airtable-diff-schema to compare two schema JSON files produced by airtable-export-schema. It reports what changed between them: tables added or removed, fields added/removed/renamed/type-changed, and views added/removed/renamed.

Comparisons are done by entity ID, so renames are detected correctly rather than showing as a remove + add.

Prerequisites

No external dependencies — the script uses the Python standard library only.

Running the Diff

# Print diff to stdout
airtable-diff-schema old_schema.json new_schema.json

# Write diff report to a file
airtable-diff-schema old_schema.json new_schema.json --output diff.md

Both arguments are schema JSON files as produced by airtable-export-schema.

Output Format

The output is a Markdown report structured as follows:

# Schema Diff: <base name>

## Tables

### Added
- TableName

### Removed
- TableName

## Fields in <TableName>

### Added
- FieldName (type)

### Removed
- FieldName

### Renamed
- OldName → NewName

### Type changed
- FieldName: oldType → newType

## Views in <TableName>

### Added
- ViewName

### Removed
- ViewName

### Renamed
- OldName → NewName

Tables and sections with no changes are omitted from the report. If there are no differences at all, the report says so explicitly.

Workflow

Export the old schema (or use a previously saved one): airtable-export-schema
Make changes in Airtable
Export the new schema: airtable-export-schema
Diff them: airtable-diff-schema old_schema.json new_schema.json

Frequently asked questions

Airtable Schema Diff