Skip to content

docs: update skill files and add blasts skill #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
KalebCole merged 1 commit into from
Mar 24, 2026
Merged

docs: update skill files and add blasts skill #39

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions skills/partiful-blasts/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 <eventId> --message "See you tonight! Parking is on the left." --to GOING,MAYBE
partiful blasts send <eventId> --message "Updated address: 123 Main St" --to GOING --show-on-event-page
```

| Flag | Description |
|------|-------------|
| `--message <text>` | Message body (**max 480 characters**) |
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Specify whether the 480-character limit is before or after the auto-prefixed text.

Line 20 and Line 42 mention the limit, while Line 8 states a prefix is added. Please clarify if the 480 limit applies to user-provided --message only, or the final rendered SMS content including prefix.

Also applies to: 42-42

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@skills/partiful-blasts/SKILL.md` at line 20, Clarify that the 480-character
limit applies to the final rendered SMS including any auto-prefixed text (not
just the user-provided --message), update the description of the `--message`
flag and the prefix note (referenced near the prefix statement and the two
mentions on lines 20 and 42) to explicitly say "480 characters total including
auto-prefixed text", and add a short note about trimming/validation behavior
(e.g., message will be rejected or truncated if the combined length exceeds 480)
so callers know how the combined length is enforced.

| `--to <statuses>` | 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 <eventId> --status going` to preview who will receive the blast.
14 changes: 12 additions & 2 deletions skills/partiful-shared/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,19 @@ description: Shared auth, global flags, and security rules for the Partiful CLI

### Login
```bash
partiful auth login
partiful auth login <phone>
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 <code>` | Provide the verification code directly (skip SMS wait) |
| `--no-auto` | Disable automatic SMS retrieval; always prompt manually |

### Check Status
```bash
Expand Down