Spark CLI Skills

Skill

Official Spark mail skills: agents read mail, calendar, contacts and teams, with flows for morning briefs, inbox zero, meeting prep, follow-ups and weekly reports. Needs Spark desktop on macOS or Windows with the CLI enabled; set read-only, organize or send access per account.

readdle/spark-cli-skills149
Открыть на GitHub
README

Spark CLI Skills

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 or Windows 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-only, triage (everything in read-only plus drafts, comments, and email/contact actions), or send (everything in triage plus sending mail and calendar invitations) - 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.

SkillDescription
use-sparkComplete 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.

SkillDescription
recipe-morning-standupToday's events + unread by category + team assignments
recipe-end-of-dayClose out the day, review loose ends, preview tomorrow
recipe-weekly-digestWeekly summary of events, email, and team status
recipe-inbox-by-categoryProcess inbox in priority order by smart category
recipe-inbox-zeroProcess the inbox to zero with category-first triage
recipe-vacation-catchupProcess a large backlog after time away with batch processing
recipe-new-sender-reviewProcess GateKeeper's new sender queue - accept or block
recipe-draft-batchReview and finalize multiple pending drafts in a batch session
recipe-multi-account-reviewReview inbox status across multiple accounts
recipe-meeting-prepGather context for an upcoming meeting
recipe-meeting-followupReview a meeting transcript and draft follow-up emails with action items
recipe-schedule-meetingFind mutual availability and suggest times
recipe-invitation-managerProcess pending invitations with availability checks
recipe-calendar-auditAnalyze meeting load, back-to-back chains, and free blocks
recipe-shared-inbox-statusReview shared inbox health - open, done, and unassigned items
recipe-shared-inbox-triageProcess open items in shared inboxes - assign, respond, mark done
recipe-team-workloadAudit team assignment distribution and spot imbalances
recipe-delegate-and-trackAssign emails to teammates with context and track delegation status
recipe-topic-timelineBuild a chronological narrative from meetings and emails
recipe-stakeholder-briefCompile a relationship dossier from all interactions with a person
recipe-priority-tuningFine-tune Spark's priority category by adjusting contact-level settings
recipe-newsletter-cleanupAudit newsletter subscriptions - block, unsubscribe, or summarize
recipe-unsubscribe-auditFull unsubscribe audit - scan all pools, classify by engagement, flag phishing/duplicates, then unsubscribe
recipe-notification-hygieneReclassify, group, and bulk-archive noisy notifications
recipe-label-organizeOrganize 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.

SkillDescription
persona-exec-assistantExecutive assistant - briefings, drafts, scheduling, contact lookup
persona-founderFounder / CEO - high-volume triage, aggressive delegation, oversight
persona-team-leadTeam lead - workload review, assignment distribution, standup prep
persona-project-managerProject manager - thread tracking, stakeholder updates, action items
persona-sales-repSales rep / account manager - pipeline review, follow-up cadence
persona-support-agentSupport agent - shared inbox processing, routing, escalation
persona-meeting-managerMeeting manager - prep, transcript review, follow-ups, scheduling
persona-freelancerFreelancer - 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