skills/notmuch/SKILL.md
Search and read local email with the `notmuch` CLI. Use when the user asks to find messages, inspect threads, or review email tags.
npx skillsauth add adampoit/ai notmuchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Search local email and inspect message threads with notmuch.
notmuch search --format=json --limit=20 'tag:unread'
Preferred command (machine-readable JSON):
notmuch search --format=json --limit=20 'from:alice subject:"design review" date:2026-02-01..'
Common query terms:
from:<email-or-name>to:<email-or-name>subject:<term>tag:<tag-name>date:YYYY-MM-DD..YYYY-MM-DDthread:<thread-id>Headers-only summary for a thread/query:
notmuch show --format=json --body=false 'thread:0000000000000123'
Full text output:
notmuch show --format=text 'thread:0000000000000123'
Structured output with bodies:
notmuch show --format=json 'thread:0000000000000123'
notmuch search --output=tags '*'
Prefer read-only commands in this skill:
notmuch search ...notmuch show ...Avoid mutating commands unless the user explicitly requests them (for example notmuch new, notmuch tag, notmuch insert).
tools
Use tmux instead of background bash for long-running, interactive, inspectable, or user-attachable terminal processes. Use for development servers, watch-mode tests, REPLs, debuggers, interactive CLIs, log tailing, and commands that may run indefinitely or need later input/inspection.
tools
Use Jujutsu (`jj`) for version control operations including status, history, diffs, commits, rebases, splits, squashes, and Git interop. Use when a repository is initialized for jj or the user asks for jj/Jujutsu workflows.
tools
Manage tasks with the `task` (Taskwarrior) CLI. Use when the user asks to review tasks, get task summaries, add work items, or complete tasks.
business
Search Slack messages and read Slack threads. Use when the user asks to search Slack, find messages, look up conversations, read thread replies, or retrieve Slack content. Triggers on requests involving Slack message lookup, conversation history, or thread reading.