AI agent skills for the Spark CLI. Install individual skills or the full set to give your AI agent structured workflows for email, calendar, contacts, teams, and meetings.
Requirements
- macOS with a recent build of Spark Desktop, signed in to at least one account.
- Spark CLI enabled: in Spark, go to Settings → AI Agents → Spark CLI Setup and follow the prompts.
- Per-account access levels -
read-onlyortriage(everything in read-only plus drafts, comments, and email/contact actions) - configured in Settings → AI Agents -> Spark CLI Access. Recipes and personas declare the level they need; running one against an account with insufficient access returns an error explaining how to upgrade.
Skills Index
Base Skill
The foundation. Every recipe and persona below depends on use-spark for the actual command reference and filter syntax - install it first.
| Skill | Description |
|---|---|
| use-spark | Complete command reference for the Spark CLI - mail, calendar, contacts, teams, meetings |
Recipes
Step-by-step workflows for a specific task. Composable - one recipe per job, run them on demand.
| Skill | Description |
|---|---|
| recipe-morning-standup | Today's events + unread by category + team assignments |
| recipe-end-of-day | Close out the day, review loose ends, preview tomorrow |
| recipe-weekly-digest | Weekly summary of events, email, and team status |
| recipe-inbox-by-category | Process inbox in priority order by smart category |
| recipe-inbox-zero | Process the inbox to zero with category-first triage |
| recipe-vacation-catchup | Process a large backlog after time away with batch processing |
| recipe-new-sender-review | Process GateKeeper's new sender queue - accept or block |
| recipe-draft-batch | Review and finalize multiple pending drafts in a batch session |
| recipe-multi-account-review | Review inbox status across multiple accounts |
| recipe-meeting-prep | Gather context for an upcoming meeting |
| recipe-meeting-followup | Review a meeting transcript and draft follow-up emails with action items |
| recipe-schedule-meeting | Find mutual availability and suggest times |
| recipe-invitation-manager | Process pending invitations with availability checks |
| recipe-calendar-audit | Analyze meeting load, back-to-back chains, and free blocks |
| recipe-shared-inbox-status | Review shared inbox health - open, done, and unassigned items |
| recipe-shared-inbox-triage | Process open items in shared inboxes - assign, respond, mark done |
| recipe-team-workload | Audit team assignment distribution and spot imbalances |
| recipe-delegate-and-track | Assign emails to teammates with context and track delegation status |
| recipe-topic-timeline | Build a chronological narrative from meetings and emails |
| recipe-stakeholder-brief | Compile a relationship dossier from all interactions with a person |
| recipe-priority-tuning | Fine-tune Spark's priority category by adjusting contact-level settings |
| recipe-newsletter-cleanup | Audit newsletter subscriptions - block, unsubscribe, or summarize |
| recipe-notification-hygiene | Reclassify, group, and bulk-archive noisy notifications |
| recipe-label-organize | Organize emails with labels and folders - attach, detach, or move |
Personas
Long-running roles that shape how the agent works across a session - tone, defaults, and which recipes to reach for. Install one persona to bias the agent toward a particular workflow style.
| Skill | Description |
|---|---|
| persona-exec-assistant | Executive assistant - briefings, drafts, scheduling, contact lookup |
| persona-founder | Founder / CEO - high-volume triage, aggressive delegation, oversight |
| persona-team-lead | Team lead - workload review, assignment distribution, standup prep |
| persona-project-manager | Project manager - thread tracking, stakeholder updates, action items |
| persona-sales-rep | Sales rep / account manager - pipeline review, follow-up cadence |
| persona-support-agent | Support agent - shared inbox processing, routing, escalation |
| persona-meeting-manager | Meeting manager - prep, transcript review, follow-ups, scheduling |
| persona-freelancer | Freelancer - multi-client management, invoice follow-ups, availability |
Installation
A typical setup is use-spark plus a handful of recipes you actually run, optionally with one persona.
# Install everything in this repo npx skills add https://github.com/readdle/spark-cli-skills # Or pick only what you need - the base skill plus one or more recipes/personas npx skills add https://github.com/readdle/spark-cli-skills/tree/main/skills/use-spark npx skills add https://github.com/readdle/spark-cli-skills/tree/main/skills/recipe-inbox-zero npx skills add https://github.com/readdle/spark-cli-skills/tree/main/skills/persona-exec-assistant
License
MIT © Spark Mail Limited