spark-recipe-schedule-meeting — Claude Code skill
Finds mutual calendar availability for multiple attendees via Spark CLI. It suggests open time slots without manual calendar checks.
npx skills add readdle/spark-cli-skills --skill spark-recipe-schedule-meeting -a claude-code
npx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a claude-codeWhat spark-recipe-schedule-meeting does
The skill coordinates meeting time selection using the spark command-line tool. It queries attendee email addresses through spark contacts and retrieves matching free intervals via spark availability.
Availability checks automatically skip weekends and restrict the search to working hours between 08:00 and 20:00. Calendar events marked as free do not block available windows. If no shared slots appear, the recipe queries attendees individually to detect scheduling conflicts.
You need the base use-spark skill installed before running this recipe. Because the skill operates under read-only access, it inspects schedules and lists available slots without modifying your calendar.
What it helps with
- find mutual open calendar slots across multiple attendees
- resolve participant email addresses from contact names
- identify which attendee schedule blocks a meeting
- filter scheduling windows across custom date ranges or a full week
Example prompts for the agent
- Find mutual free time for a meeting with Alice and Bob tomorrow.
- Check shared availability with [email protected] for the full week.
- See when [email protected] is busy between 2026-04-10 and 2026-04-11 to locate calendar conflicts.
How to install spark-recipe-schedule-meeting
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill spark-recipe-schedule-meeting -a claude-codenpx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a claude-code2Manually: put the files in place
~/.claude/skills/recipe-schedule-meeting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recipe-schedule-meeting/
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a codex2Manually: put the files in place
.agents/skills/recipe-schedule-meeting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a cursor2Manually: put the files in place
.cursor/skills/recipe-schedule-meeting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install readdle/spark-cli-skills recipe-schedule-meeting2Manually: put the files in place
.github/skills/recipe-schedule-meeting/SKILL.md1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a gemini-cli2Platform CLI
gemini skills install https://github.com/readdle/spark-cli-skills --path skills/recipe-schedule-meetingManually: put the files in place
.devin/skills/recipe-schedule-meeting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-schedule-meeting -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about spark-recipe-schedule-meeting
How to install spark-recipe-schedule-meeting in Claude Code?
Run npx skills add readdle/spark-cli-skills --skill spark-recipe-schedule-meeting -a claude-code in your terminal.
What does spark-recipe-schedule-meeting do?
It identifies overlapping free calendar slots between you and your attendees using Spark CLI commands and formats the open slots with their duration.
Does spark-recipe-schedule-meeting create calendar events?
No, the skill requires read-only access. It only analyzes calendar availability and lists potential meeting options for the user.
Source text
SKILL.md · MIT
---
name: spark-recipe-schedule-meeting
description: >-
Find mutual availability with attendees and suggest meeting times.
metadata:
version: 1.0.0
requires:
skills:
- use-spark
accessLevel: read-only
---
# Recipe: Schedule a Meeting
Find mutual availability with attendees and present time slot options for scheduling.
**Prerequisite:** Read the `use-spark` base skill for command reference and filter syntax.
**Access level required:** read-only.
## Steps
### Step 1: Look up attendee emails
```bash
spark contacts "attendee name"
```
Repeat for each attendee to get their email addresses.
### Step 2: Find mutual availability
For tomorrow:
```bash
spark availability --tomorrow --attendees [email protected],[email protected]
```
For a specific date range:
```bash
spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected],[email protected]
```
For the full week:
```bash
spark availability --week --attendees [email protected],[email protected]
```
### Step 3: Present the options
List the available time slots for the user to choose from. Include:
- Date and time range for each slot
- Duration of each slot (so the user knows if a 1-hour meeting fits)
### Step 4: Narrow down if needed
If no slots work, try a broader window:
```bash
spark availability --start 2026-04-10 --end 2026-04-14 --attendees [email protected],[email protected]
```
Or check individual availability to find who's blocking:
```bash
spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected]
spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected]
```
## Tips
- `availability` respects working hours (08:00-20:00) and skips weekends automatically.
- Events marked as "free" in the calendar are ignored - they don't block availability.
- Without `--attendees`, the command shows the user's own free time.
- For large groups, narrow the date range to get focused results.
- If the user provides names instead of emails, use `spark contacts` first to resolve them.
- The free slots are computed as mutual windows - times when all attendees and the user are available.
© readdle · MIT · readdle/spark-cli-skills
