home / skills / plurigrid / asi / partiful

partiful skill

/skills/partiful

This skill accesses Partiful event data and RSVPs via API conversations, helping you view invites, RSVP statuses, and event details quickly.

npx playbooks add skill plurigrid/asi --skill partiful

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
2.0 KB
---
name: partiful
description: Access Partiful events, invites, and RSVPs via reverse-engineered API. Use when user asks about party invites, event RSVPs, or social event data.
---

# Partiful

Programmatic access to Partiful event data via Babashka.

## Quick Start

```bash
# List all RSVPs/invites
bb scripts/partiful.clj invites

# Get event details
bb scripts/partiful.clj event <event-id>

# Authenticate (opens browser)
bb scripts/partiful.clj auth
```

## Commands

| Command | Description |
|---------|-------------|
| `invites` | List events you're invited to with RSVP status |
| `events` | List events you're hosting |
| `mutuals` | List mutual connections |
| `event <id>` | Get full details for an event |
| `auth` | Authenticate via Playwright browser |

## Configuration

Set environment variables or store in `~/.partiful-config.edn`:

```bash
export PARTIFUL_AUTH_TOKEN="..."
export PARTIFUL_USER_ID="..."
export PARTIFUL_REFRESH_TOKEN="..."
export PARTIFUL_FIREBASE_API_KEY="..."  # Get from Partiful web app
```

## ACSet Schema

Category-theoretic event modeling with morphisms:

```
  Event <──host──── User
    ^                 ^
    │                 │
 event_of          invitee
    │                 │
    └─── Invite ─────┘
           ↓
         RSVP
```

See `scripts/partiful-acset.clj` for queries:
- `my-invited-events` - Events user is invited to
- `event-guests` - All guests for an event
- `event-rsvps` - RSVP statuses for event



## SDF Interleaving

This skill connects to **Software Design for Flexibility** (Hanson & Sussman, 2021):

### Primary Chapter: 5. Evaluation

**Concepts**: eval, apply, interpreter, environment

### GF(3) Balanced Triad

```
partiful (○) + SDF.Ch5 (−) + [balancer] (+) = 0
```

**Skill Trit**: 0 (ERGODIC - coordination)


### Connection Pattern

Evaluation interprets expressions. This skill processes or generates evaluable forms.
## Cat# Integration

```
Trit: +1 (PLUS)
Color: #FF6B35 (warm/executor)
Triads: partiful(+1) + acsets(0) + calendar-acset(-1) = 0
```

Overview

This skill provides programmatic access to Partiful event data through a reverse-engineered API. It surfaces events, invites, guest lists, and RSVP statuses and supports authentication for private or user-scoped queries. Use it to fetch, filter, and inspect social event data for integrations, analytics, or automation workflows.

How this skill works

The skill talks to Partiful endpoints using stored auth tokens and a small client flow that can open a browser for initial authentication. It inspects event metadata, invite relationships, and RSVP objects and returns structured results for queries like "my invited events," "event guests," and "event RSVPs." Queries can be run ad hoc or integrated into scripts to power dashboards, notifications, or sync jobs.

When to use it

  • When you need a machine-readable list of events you are invited to or hosting
  • When you want up-to-date RSVP counts and guest lists for an event
  • When automating attendee notifications, reminders, or analytics
  • When syncing Partiful event data into calendars, CRMs, or reporting tools
  • When debugging invite relationships or mutual connections for social planning

Best practices

  • Store authentication tokens securely in environment variables or a protected config file
  • Use authenticated queries for private events and rate-limit polling to avoid excessive requests
  • Filter server-side by event ID or user ID to minimize data transfer
  • Cache RSVP snapshots for periodic analytics rather than polling in real time
  • Validate and sanitize returned fields before feeding them into downstream systems

Example use cases

  • List all events you are invited to with current RSVP status for a daily digest
  • Fetch full event details and guest lists to sync into a calendar or event management app
  • Generate attendance reports by aggregating RSVP statuses across multiple events
  • Automate reminder messages to guests who RSVP'ed yes or maybe before an event
  • Inspect mutual connections and invite chains when planning group invites or collaborations

FAQ

Do I need an account to use the skill?

Yes. Private or user-scoped queries require authentication via tokens obtained from the Partiful web flow; public event details may be accessible without full auth.

How is authentication handled?

Authenticate once through the browser flow to obtain tokens and refresh tokens; store them in environment variables or a local config to reuse for API calls.