From 433c7b34790c1c6b26b8eedd5b19e3deae3554c2 Mon Sep 17 00:00:00 2001 From: Kaleb Cole Date: Tue, 24 Mar 2026 07:42:55 -0700 Subject: [PATCH] docs: update SKILL.md files and add blasts skill - partiful-shared: Replace bookmarklet auth with phone-based auth flow (partiful auth login ), document auto SMS retrieval via imsg, --code and --no-auto flags, E.164 format requirement - partiful-blasts: New skill documenting text blast command with --to statuses, 480 char limit, --dry-run, safety confirmation - partiful-events and partiful-guests: Reviewed, no changes needed --- skills/partiful-blasts/SKILL.md | 44 +++++++++++++++++++++++++++++++++ skills/partiful-shared/SKILL.md | 14 +++++++++-- 2 files changed, 56 insertions(+), 2 deletions(-) create mode 100644 skills/partiful-blasts/SKILL.md diff --git a/skills/partiful-blasts/SKILL.md b/skills/partiful-blasts/SKILL.md new file mode 100644 index 0000000..afd8b7b --- /dev/null +++ b/skills/partiful-blasts/SKILL.md @@ -0,0 +1,44 @@ +--- +name: partiful-blasts +description: Send text blasts to event guests via Partiful +--- + +# Partiful CLI — Text Blasts + +> ⚠️ **Real SMS messages.** Blasts send actual text messages to real people's phones. Partiful prepends: *"The host of {Event} sent a Text Blast —"* before your message. + +## Commands + +### Send a Text Blast +```bash +partiful blasts send --message "See you tonight! Parking is on the left." --to GOING,MAYBE +partiful blasts send --message "Updated address: 123 Main St" --to GOING --show-on-event-page +``` + +| Flag | Description | +|------|-------------| +| `--message ` | Message body (**max 480 characters**) | +| `--to ` | Comma-separated guest statuses to target (see below) | +| `--show-on-event-page` | Also display the blast on the event page | +| `--yes` | Skip the safety confirmation prompt | +| `--dry-run` | Preview recipients and message without sending | + +### Valid `--to` Values + +| Status | Description | +|--------|-------------| +| `GOING` | Confirmed guests | +| `MAYBE` | Tentative guests | +| `DECLINED` | Guests who declined | +| `SENT` | Invited but no response | +| `INTERESTED` | Expressed interest | +| `WAITLIST` | On the waitlist | +| `APPROVED` | Approved from waitlist | +| `RESPONDED_TO_FIND_A_TIME` | Responded to scheduling poll | + +## Tips + +- **Always use `--dry-run` first** to verify the recipient list and message. +- The 480-character limit is enforced by Partiful's API — the CLI will reject longer messages before sending. +- Without `--yes`, the CLI shows a confirmation prompt with the recipient count and message preview. +- Combine with `partiful guests list --status going` to preview who will receive the blast. diff --git a/skills/partiful-shared/SKILL.md b/skills/partiful-shared/SKILL.md index 9dddc43..a111d06 100644 --- a/skills/partiful-shared/SKILL.md +++ b/skills/partiful-shared/SKILL.md @@ -9,9 +9,19 @@ description: Shared auth, global flags, and security rules for the Partiful CLI ### Login ```bash -partiful auth login +partiful auth login +partiful auth login +15551234567 ``` -Opens a bookmarklet-based flow to capture your Partiful session token. +Phone-based authentication. Phone number must be in **E.164 format** (e.g. `+15551234567`). + +1. Sends an SMS verification code to the provided number. +2. **On macOS:** Automatically retrieves the code from iMessage (via `imsg`). No manual input needed. +3. **Fallback:** If auto-retrieval fails, prompts you to enter the code manually. + +| Flag | Description | +|------|-------------| +| `--code ` | Provide the verification code directly (skip SMS wait) | +| `--no-auto` | Disable automatic SMS retrieval; always prompt manually | ### Check Status ```bash