Airtable schema diff

Skill mickzijdel/airtable-utils/skills/airtable-schema-diff

Airtable Scripting agent skill and tools for schema dump, schema diff, and user check

Install

npx -y skills add mickzijdel/airtable-utils --skill airtable-schema-diff

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

1.8 KB, as published. Nobody here has run it

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