airtable

name	airtable
description	Search Airtable bases and tables, read records and computed fields, and prepare guarded record CRUD requests with schema-based field validation.
user-invocable	true
requires	{"bins":["node"]}
credentials	[{"id":"airtable-pat","kind":"bearer","required":true,"secret_ref":{"source":"store","id":"AIRTABLE_PAT"},"scope":"api.airtable.com/v0","how_to_obtain":"Create an Airtable Personal Access Token or OAuth bearer token with the needed scopes. Set `AIRTABLE_PAT` through browser admin at the active `/admin/secrets` route; if browser admin is unavailable, use `/secret set AIRTABLE_PAT \"<token>\"` in browser `/chat` or TUI; local console fallback: `hybridclaw secret set AIRTABLE_PAT \"<token>\"`."}]
metadata	{"hybridclaw":{"category":"productivity","short_description":"Airtable bases, tables, records, attachments, and safe writes.","tags":["airtable","records","bases","tables","attachments","formulas"],"stakes_tiers":{"green":"[Truncated]","amber":"[Truncated]","red":"[Truncated]"},"escalation":{"writes":"confirm-each","route":"f14"},"cost_measurement":{"system":"UsageTotals","sub_limit_contract":"R5.4","sub_limit_key":"airtable"}}}

Airtable

Use this skill for Airtable Web API work: base and table discovery, schema inspection, record reads, field-aware record creation and updates, attachment field payloads, formula/lookup/rollup reads, and carefully gated deletes.

Scope

• list accessible bases
• inspect base table schemas, field ids, field names, field types, and select choices
• list records with pagination, views, field selection, and filterByFormula
• fetch a single record by id
• create, update, and delete records only after explicit operator grant
• validate field values against Airtable metadata before writes when schema is available
• prepare attachment field values from public http(s) URLs
• read formula, lookup, rollup, count, autonumber, created time, and last modified time fields as normal record values
• refuse writes to computed/read-only field types
• measure skill run cost through normal HybridClaw UsageTotals

Credential Rules

Airtable uses Personal Access Tokens or OAuth bearer tokens. Store the token in HybridClaw encrypted runtime secrets; never paste it into the prompt.

Recommended setup order:

1. Browser admin: open the active HybridClaw admin URL ending in /admin/secrets and set AIRTABLE_PAT.
2. Browser /chat or TUI fallback: /secret set AIRTABLE_PAT "<pat-or-oauth-access-token>".
3. Local console fallback:

hybridclaw secret set AIRTABLE_PAT "<pat-or-oauth-access-token>"

For live API calls inside HybridClaw, use the helper to build the http_request payload wrapper, then pass the emitted inner httpRequest object to the built-in http_request tool. The helper sets bearerSecretName: "AIRTABLE_PAT" on that inner object so the gateway injects the bearer token server-side. Do not use bash/curl for live Airtable calls when http_request is available, and do not ask the user to store a HybridClaw gateway token as an Airtable secret.

Do not try to verify AIRTABLE_PAT with bash, environment inspection, or by asking the model whether the secret exists. The model cannot inspect the gateway secret store. If the operator says the secret was set, attempt the http_request call with . Only say the secret is missing if the built-in tool returns a gateway error that explicitly says is not set, unavailable, missing, or unresolved. If the error says the secret is blocked by policy, report a policy/runtime configuration problem instead of asking the operator to set the same secret again.