# Send Airtable Participants to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "airtable-participants",
    "name": "Airtable Participants",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/austinmao/airtable-participants",
    "canonicalUrl": "https://clawhub.ai/austinmao/airtable-participants",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/airtable-participants",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=airtable-participants",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/airtable-participants"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/airtable-participants",
    "downloadUrl": "https://openagent3.xyz/downloads/airtable-participants",
    "agentUrl": "https://openagent3.xyz/skills/airtable-participants/agent",
    "manifestUrl": "https://openagent3.xyz/skills/airtable-participants/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/airtable-participants/agent.md"
  }
}
```
## Documentation

### Purpose

Query retreat participant data from the Ceremonia Airtable base. This is the
authoritative source of truth for who receives emails and SMS messages.
Access is read-only by default — record modifications require Austin's
explicit instruction per change.

### Required Setup

Ensure AIRTABLE_API_KEY is set in .env.

You will also need:

Base ID: [VERIFY — find in Airtable API docs at airtable.com/developers or ask Austin]
Table name: [VERIFY — confirm the participant table name with Austin]

Store confirmed values in TOOLS.md and MEMORY.md once verified.

### Expected Data Structure

Participant records are expected to have at minimum these fields:

FieldTypeDescriptionnameTextFull nameemailEmailPrimary email addressphonePhoneE.164 format preferred (+1XXXXXXXXXX)retreat_statusSelecte.g., active, alumni, prospective, unsubscribedtagsMulti-selecte.g., february-2026, guide-circle, donorlast_contactDateMost recent outreach datedonation_statusSelecte.g., donor, non-donor

[VERIFY actual field names with Austin on first use — update this section when confirmed]

### Get all active participants (for newsletter sends)

curl -s "https://api.airtable.com/v0/{BASE_ID}/{TABLE_NAME}?filterByFormula={retreat_status}='active'&fields[]=name&fields[]=email" \\
  -H "Authorization: Bearer $AIRTABLE_API_KEY" | jq '.records[].fields'

### Get participants with phone numbers (for SMS campaigns)

curl -s "https://api.airtable.com/v0/{BASE_ID}/{TABLE_NAME}?filterByFormula=AND({retreat_status}='active',{phone}!='')&fields[]=name&fields[]=phone" \\
  -H "Authorization: Bearer $AIRTABLE_API_KEY" | jq '.records[].fields'

### Get participant count by status

curl -s "https://api.airtable.com/v0/{BASE_ID}/{TABLE_NAME}?fields[]=retreat_status" \\
  -H "Authorization: Bearer $AIRTABLE_API_KEY" | jq '[.records[].fields.retreat_status] | group_by(.) | map({status: .[0], count: length})'

### Get participants by tag

curl -s "https://api.airtable.com/v0/{BASE_ID}/{TABLE_NAME}?filterByFormula=FIND('february-2026',ARRAYJOIN({tags}))" \\
  -H "Authorization: Bearer $AIRTABLE_API_KEY" | jq '.records[].fields'

Note: Airtable paginates at 100 records. Use the offset parameter from the response to fetch subsequent pages:

curl -s "https://api.airtable.com/v0/{BASE_ID}/{TABLE_NAME}?offset={OFFSET_TOKEN}" \\
  -H "Authorization: Bearer $AIRTABLE_API_KEY" | jq .

Always paginate fully before reporting totals or building recipient lists.

### Behavior Rules

Read-only by default — never PATCH, POST, or DELETE Airtable records without Austin's explicit instruction per operation
When building a recipient list for email or SMS: always filter out records where retreat_status is 'unsubscribed'
Never include email addresses or phone numbers in Slack messages — summarize counts and segments only
If a query returns 0 results unexpectedly: report the issue to Austin rather than sending to an empty list
Paginate all list queries fully — do not report partial counts or build partial recipient lists
If Airtable API returns an error: surface it to Austin immediately with the error code and message

### Record Modification (Requires Austin Approval)

When Austin instructs a record change (e.g., marking someone unsubscribed, updating last_contact):

Confirm the specific change with Austin before executing
Execute the PATCH request
Log the change in memory/logs/crm-writes/YYYY-MM-DD.md with: record name/email, field changed, old value, new value, Austin's instruction timestamp

### Example Invocations

"How many active participants do we have?"
"Get the email list for the February retreat attendees"
"Who attended the last three retreats?"
"How many people have phone numbers in the system?"
"Mark [name] as unsubscribed" (requires Austin approval)
"Pull the full active participant list for the newsletter"
"How many people joined since January?"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: austinmao
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/airtable-participants)
- [Send to Agent page](https://openagent3.xyz/skills/airtable-participants/agent)
- [JSON manifest](https://openagent3.xyz/skills/airtable-participants/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/airtable-participants/agent.md)
- [Download page](https://openagent3.xyz/downloads/airtable-participants)