spark-recipe-shared-inbox-status — Claude Code skill: shared inbox
Reports how many emails in shared inboxes are still open, which ones have no owner, and how assignments sit across the team.
npx skills add readdle/spark-cli-skills --skill spark-recipe-shared-inbox-status -a claude-code
npx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -a claude-codeWhat spark-recipe-shared-inbox-status does
The skill runs a set of spark commands and builds a status report per shared inbox: open items, completed work, unassigned emails, and a per-member assignment breakdown. It starts with spark accounts to find the inboxes and their teams, then filters with is:shared_inbox_open, assigned_to:unassigned and is:shared_inbox_done. To see one person's load, use spark team "Team Name" or filter by their address.
Six steps, no automation behind them. The skill reads mail and adds up the numbers. Access level is read-only. Read the base use-spark skill first — that is where the command reference and filter syntax live, and the steps depend on them. With several inboxes, each gets its own report and then a combined summary.
The unassigned count is the line worth reading. A high open count with few unassigned items means work is spread out but not being closed, so check for stale assignments. The author suggests running this daily on active inboxes and weekly on quieter ones.
What it helps with
- see how many emails in a shared inbox still need action
- find emails nobody has picked up
- compare per-member assignment counts across a team
- gauge recent throughput from completed items
- spot stale assignments when open counts stay high
Example prompts for the agent
- check the status of the shared inbox [email protected]
- show me how many emails in the shared inbox are unassigned
- compare team assignment load in the shared inbox
How to install spark-recipe-shared-inbox-status
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill spark-recipe-shared-inbox-status -a claude-codenpx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -a claude-code2Manually: put the files in place
~/.claude/skills/recipe-shared-inbox-status/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recipe-shared-inbox-status/
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -a codex2Manually: put the files in place
.agents/skills/recipe-shared-inbox-status/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -a cursor2Manually: put the files in place
.cursor/skills/recipe-shared-inbox-status/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install readdle/spark-cli-skills recipe-shared-inbox-status2Manually: put the files in place
.github/skills/recipe-shared-inbox-status/SKILL.md1Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -a gemini-cli2Platform CLI
gemini skills install https://github.com/readdle/spark-cli-skills --path skills/recipe-shared-inbox-statusManually: put the files in place
.devin/skills/recipe-shared-inbox-status/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add readdle/spark-cli-skills --skill recipe-shared-inbox-status -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-shared-inbox-status
How do I install spark-recipe-shared-inbox-status in Claude?
Run npx skills add readdle/spark-cli-skills --skill spark-recipe-shared-inbox-status -a claude-code. The skill lands in ~/.claude/skills/recipe-shared-inbox-status/SKILL.md.
What does spark-recipe-shared-inbox-status do?
It builds a report per shared inbox: open and done items, unassigned emails, and how assignments are distributed across team members.
What does the skill need to run?
Read-only access and the base use-spark skill, which holds the command reference and filter syntax the steps rely on.
Source text
SKILL.md · MIT
---
name: spark-recipe-shared-inbox-status
description: >-
Review shared inbox health: open vs. done items, unassigned work,
and per-member assignment breakdown.
metadata:
version: 1.0.0
requires:
skills:
- use-spark
accessLevel: read-only
---
# Recipe: Shared Inbox Status
Review the health of one or more shared inboxes - open items, completed work, unassigned emails, and how assignments are distributed across team members.
**Prerequisite:** Read the `use-spark` base skill for command reference and filter syntax.
**Access level required:** read-only.
## Steps
### Step 1: Discover shared inboxes
```bash
spark accounts
```
Note each shared inbox address and the team it belongs to.
### Step 2: Check open items
For each shared inbox:
```bash
spark emails [email protected]:Inbox --filter "is:shared_inbox_open"
```
These are active items that still need attention.
### Step 3: Check unassigned items
```bash
spark emails [email protected]:Inbox --filter "assigned_to:unassigned"
```
Unassigned items are falling through the cracks - no one owns them yet.
### Step 4: Review per-member assignments
```bash
spark team "Team Name"
```
The assignment summary shows how work is distributed. For a deeper look at a specific member's load:
```bash
spark emails [email protected]:Inbox --filter "assigned_to:[email protected]"
spark emails [email protected]:Inbox --filter "assigned_to:[email protected]"
```
### Step 5: Check completed items
```bash
spark emails [email protected]:Inbox --filter "is:shared_inbox_done"
```
Review recently completed items for a sense of throughput.
### Step 6: Present the status
Report per shared inbox:
- **Open:** N items awaiting action
- **Unassigned:** M items with no owner
- **Per member:** assignment counts (flag anyone with significantly more or fewer)
- **Done:** K items completed recently
If there are multiple shared inboxes, present each separately, then a combined summary.
## Tips
- Run this daily for active shared inboxes, weekly for quieter ones.
- Unassigned items are the most actionable finding - they represent work that nobody is looking at.
- Combine per-member counts with `recipe-team-workload` for a fuller picture of who has bandwidth.
- If a shared inbox has high open count but low unassigned count, work is distributed but not being closed - look for stale assignments.
- Use `spark thread <id>` to read any item that looks stale or unusual.
- For teams with multiple shared inboxes, the total unassigned count across all inboxes is the key metric.
© readdle · MIT · readdle/spark-cli-skills