airtable-data-sample

Fetch sample Airtable rows to inspect field shapes and linked-record IDs.

2|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/TMI-apps/boilerplate-vite-supabase-mui-cursor --skill airtable-data-sample
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airtable-data-sample
Source: https://github.com/TMI-apps/boilerplate-vite-supabase-mui-cursor/tree/main/.cursor/skills/airtable-data-sample
Command: npx skills add https://github.com/TMI-apps/boilerplate-vite-supabase-mui-cursor --skill airtable-data-sample

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Fetch a few Airtable rows to inspect cell shapes (attachments, rich text, URLs, linked-record ids) with fld… keys. Requires schema skill first. Safe defaults: low maxRecords, optional fields allowlist, redact PII in chat. Triggers: sample rows, cell shape, returnFieldsByFieldId, verify wire JSON vs app normalization.

Core Features & Use Cases

  • Script-based sample fetch: runs node scripts/airtable-sample-records.js to print JSON (records[].fields).
  • App integration guidance: airtableService.ts may normalize or select fields for the UI.
  • Safety and governance: redact PII, limit records, and avoid exposing production data.

Quick Start

Run the sample script to print records[].fields for a small set of Airtable rows and review the returned fld… keys.

Frequently Asked Questions about airtable-data-sample

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inspect Airtable field shapes for attachments and linked records?

To inspect Airtable field shapes, fetch sample rows using a script that outputs records[].fields, revealing cell structures like attachments, rich text, URLs, and linked-record IDs alongside their fld… keys.

What's the best way to verify wire JSON vs app normalization for Airtable data?

Verify wire JSON by fetching raw sample Airtable records and printing records[].fields, allowing you to compare actual API output against how airtableService.ts normalizes or selects fields for the UI.

Do I need the Airtable schema skill before sampling records?

Yes, the Airtable schema skill is required before sampling records. You must first understand the base schema so the sample fetch can correctly interpret and output the returned fld… field keys.

Can I limit Airtable sample records to avoid exposing production data?

You can limit exposure by setting a low maxRecords value and using an optional fields allowlist. The script also supports redacting PII in chat to maintain safe data governance during testing.

How does returnFieldsByFieldId work when fetching Airtable sample rows?

Using returnFieldsByFieldId returns field keys as raw fld… identifiers instead of field names, which helps map field-level UI components and verify wire JSON structures against app normalization logic.

Why does my Airtable attachment field show unexpected JSON structures?

Airtable attachment fields return complex nested JSON shapes. Fetching sample rows reveals these exact cell structures within records[].fields, helping you map the attachment URLs and metadata correctly for your UI.