From airtable-utils
Check an Airtable schema JSON file against the BlueDot Impact Airtable Standards. Use when the user wants to validate their Airtable base structure, find naming convention violations, or produce a standards compliance report.
How this skill is triggered — by the user, by Claude, or both
Slash command
/airtable-utils:airtable-standards-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill covers running `airtable-check-standards` to validate a schema JSON file (produced by `airtable-export-schema`) against the [BlueDot Impact Airtable Standards](https://github.com/bluedotimpact/airtable-standards). It outputs a Markdown report grouped by table, listing errors and warnings for each rule violation.
This skill covers running airtable-check-standards to validate a schema JSON file (produced by airtable-export-schema) against the BlueDot Impact Airtable Standards. It outputs a Markdown report grouped by table, listing errors and warnings for each rule violation.
No external dependencies — the script uses the Python standard library only. No API token or network access needed.
# Check a schema and print report to stdout
airtable-check-standards schema.json
# Suppress warnings, show errors only
airtable-check-standards schema.json --errors-only
# Write the report to a file
airtable-check-standards schema.json --output report.md
# Both flags combined
airtable-check-standards schema.json --errors-only --output report.md
The script exits with code 0 if no errors are found, or 1 if any errors are found — making it suitable for CI pipelines.
The following rules are checked automatically:
| Rule | Severity | Check |
|---|---|---|
table-sentence-case | error | Table name starts with uppercase |
table-singular | warning | Table name isn't plural (heuristic) |
table-description-keys | warning | Description has "Description:" and "Last reviewed on:" |
table-missing-all-view | warning | Table has an "All" view |
field-sentence-case | error | Field name (after [prefix] strip) starts with uppercase |
field-boolean-is-prefix | warning | Checkbox fields start with "Is " |
field-date-on-suffix | warning | Date fields end in " on" |
field-datetime-at-suffix | warning | DateTime fields end in " at" |
field-repeats-table-name | warning | Field name doesn't repeat table name words |
The following standards cannot be checked automatically and require human judgment:
airtable-export-schema --token ... --base ...airtable-check-standards {base_id}_{name}_{timestamp}_schema.jsonCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub mickzijdel/airtable-utils --plugin airtable-utils