Skill

managing-inbox-recipe

Manages personal inbox/notes with priorities, urgency levels, and status tracking. Use when user asks about notes, tasks, inbox, what to check, or when managing prioritized items.

npx claudepluginhub andercore-labs/claudes-kitchen --plugin workflows

Tool Access

This skill uses the workspace's default tool permissions.

Preview

**Add → List → Done → Archive → Clear**

Supporting Assets

inbox.jspackage.json

SKILL.md

Similar Skills

agent-introspection-debugging

169.4k

Implements structured self-debugging workflow for AI agent failures: capture errors, diagnose patterns like loops or context overflow, apply contained recoveries, and generate introspection reports.

everything-claude-code

canary-watch

169.4k

Monitors deployed URLs for regressions in HTTP status, console errors, performance metrics, content, network, and APIs after deploys, merges, or upgrades.

everything-claude-code

frontend-patterns

169.4k

Provides React and Next.js patterns for component composition, compound components, state management, data fetching, performance optimization, forms, routing, and accessible UIs.

everything-claude-code

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 20, 2026

Actions

View Source View Plugin View on GitHub View README

Inbox Management

Quick Reference

Add → List → Done → Archive → Clear

inbox add URGENT High yes "Review Nuno's PR"
inbox list
inbox done note-123456
inbox archive note-123456
inbox clear-done

When to Use

query: "what's in my inbox" | "my notes" | "what should I check" | "pending items" → list
request: "add note" | "track this" | "remember" → add
action: "mark done" | "archive this" → done/archive

Setup

[ ! -d ~/.inbox ] && mkdir -p ~/.inbox

[ ! -f ~/.inbox/inbox ] && {
  cp inbox.js ~/.inbox/inbox
  chmod +x ~/.inbox/inbox
  echo "✓ Inbox CLI installed to ~/.inbox/inbox"
}

Add to PATH (optional):

echo 'export PATH="$HOME/.inbox:$PATH"' >> ~/.zshrc
source ~/.zshrc

Core Operations

Operation	Command	Output
Add note	`inbox add <urgency> <priority> <yes\|no> <msg>`	Confirmation + ID
List active	`inbox list`	Prioritized active notes
List done	`inbox list done`	Completed notes
List archived	`inbox list archived`	Archived notes
Mark done	`inbox done <note_id>`	Confirmation
Archive	`inbox archive <note_id>`	Confirmation
Remove	`inbox remove <note_id>`	Confirmation
Clear done	`inbox clear-done`	Count removed
Clear archived	`inbox clear-archived`	Count removed

Note Structure

{
  "id": "note-1761319523-abc123",
  "createdAt": "2025-10-24T15:25:23.000Z",
  "message": "Review PR #123",
  "urgency": "URGENT",
  "priority": "High",
  "actionNeeded": true,
  "status": "active",
  "link": "https://github.com/org/repo/pull/123",
  "metadata": {
    "source": "slack",
    "sender": "Nuno"
  }
}

Adding Notes

Manual:

inbox add URGENT High yes "Review security PR"
inbox add MEDIUM Medium no "Read architecture docs"
inbox add LOW Low no "Update team on progress"

Output:

✓ Note added (note-1761319523-abc123)

Programmatic (from other tools):

import { addNoteWithMetadata } from './inbox.js';

addNoteWithMetadata({
  message: "Review Nuno's PR",
  urgency: "URGENT",
  priority: "High",
  actionNeeded: true,
  link: "https://github.com/org/repo/pull/123",
  metadata: { source: "slack", sender: "Nuno" }
});

Listing Notes

Active (default):

inbox list

Output:

📬 Active Notes (3)

1. 🔴 ⚠️ Nuno [slack] (URGENT)
   Review Nuno's PR
   https://github.com/org/repo/pull/123
   ID: note-1761319523-abc123

2. 🟡 ⚠️ Note (MEDIUM)
   Prepare deployment plan
   ID: note-1761319524-def456

3. 🟢 Note (LOW)
   Update documentation
   ID: note-1761319525-ghi789

Done:

inbox list done

Archived:

inbox list archived

Managing Notes

Mark as done:

inbox done note-1761319523-abc123

Output:

✓ Note marked as done: note-1761319523-abc123

Archive:

inbox archive note-1761319523-abc123

Remove:

inbox remove note-1761319523-abc123

Clear all done:

inbox clear-done

Output:

✓ Cleared 5 done notes

Clear all archived:

inbox clear-archived

Priority Sorting

Sort: urgency (URGENT→HIGH→MEDIUM→LOW) → priority (High→Medium→Low) → action_needed (yes→no) → timestamp (newest→oldest)

Indicators:

Level	Icon	Action
URGENT	🔴	High priority
HIGH	🟠	High priority
MEDIUM	🟡	Medium priority
LOW	🟢	Low priority
Action needed	⚠️	Requires response

Integration Patterns

Slack messages → Inbox:

# Slack skill calls inbox programmatically
node ~/.slack/slack.js assistant
# → DM received → analyzed → added to inbox

GitHub PRs → Inbox:

inbox add HIGH High yes "Review PR #123"
# Link: https://github.com/org/repo/pull/123

Jira tickets → Inbox:

inbox add MEDIUM Medium yes "Fix JIRA-123"
# Link: https://jira.company.com/browse/JIRA-123

Workflow

add → list (active) → done/archive → list done → clear-done
add → list → remove (no history)

Storage

Location:

~/.inbox/notes.json

Format:

{
  "notes": [
    { "id": "note-...", "status": "active", ... },
    { "id": "note-...", "status": "done", ... }
  ]
}

Validation

Phase	Command	Expected
Install	`inbox`	Help text
Add	`inbox add URGENT High yes "test"`	Note added
List	`inbox list`	Note displayed
Done	`inbox done <id>`	Marked done
List done	`inbox list done`	Shows done note
Clear	`inbox clear-done`	Removed

Example Session

$ inbox add URGENT High yes "Review security PR #456"
✓ Note added (note-1761319523-abc123)

$ inbox add MEDIUM Medium no "Read docs"
✓ Note added (note-1761319524-def456)

$ inbox list
📬 Active Notes (2)

1. 🔴 ⚠️ Note (URGENT)
   Review security PR #456
   ID: note-1761319523-abc123

2. 🟡 Note (MEDIUM)
   Read docs
   ID: note-1761319524-def456

$ inbox done note-1761319523-abc123
✓ Note marked as done: note-1761319523-abc123

$ inbox list
📬 Active Notes (1)

1. 🟡 Note (MEDIUM)
   Read docs
   ID: note-1761319524-def456

$ inbox list done
📬 Done Notes (1)

1. 🔴 ⚠️ Note (URGENT)
   Review security PR #456
   ID: note-1761319523-abc123

$ inbox clear-done
✓ Cleared 1 done note