home / skills / plurigrid / asi / 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 partifulReview the files below or copy the command above to add this skill to your agents.
---
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
```
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.
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.
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.