partner-built/slack/skills/slack-search/SKILL.md
Guidance for effectively searching Slack to find messages, files, channels, and people
npx skillsauth add anthropics/knowledge-work-plugins slack-searchInstall 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.
This skill provides guidance for effectively searching Slack to find messages, files, and information.
Apply this skill whenever you need to find information in Slack — including when a user asks you to locate messages, conversations, files, or people, or when you need to gather context before answering a question about what's happening in Slack.
| Tool | Use When |
|------|----------|
| slack_search_public | Searching public channels only. Does not require user consent. |
| slack_search_public_and_private | Searching all channels including private, DMs, and group DMs. Requires user consent. |
| slack_search_channels | Finding channels by name or description. |
| slack_search_users | Finding people by name, email, or role. |
in:, from:, date ranges).project X deadline) — Best for finding specific, exact content.Don't rely on a single search. Break complex questions into smaller searches:
in:channel-name — Search within a specific channelin:<#C123456> — Search in channel by ID-in:channel-name — Exclude a channelin:<@U123456> — Search in DMs with a userfrom:<@U123456> — Messages from a specific user (by ID)from:username — Messages from a user (by Slack username)to:me — Messages sent directly to youis:thread — Only threaded messageshas:pin — Pinned messageshas:link — Messages containing linkshas:file — Messages with file attachmentshas::emoji: — Messages with a specific reactionbefore:YYYY-MM-DD — Messages before a dateafter:YYYY-MM-DD — Messages after a dateon:YYYY-MM-DD — Messages on a specific dateduring:month — Messages during a specific month (e.g., during:january)"exact phrase" — Match an exact phrase-word — Exclude messages containing a wordwild* — Wildcard matching (minimum 3 characters before *)To search for files, use the content_types="files" parameter with type filters:
type:images — Image filestype:documents — Document filestype:pdfs — PDF filestype:spreadsheets — Spreadsheet filestype:canvases — Slack CanvasesExample: content_types="files" type:pdfs budget after:2025-01-01
After finding relevant messages:
slack_read_thread to get the full thread context for any threaded message.slack_read_channel with oldest/latest timestamps to read surrounding messages for context.slack_read_user_profile to identify who a user is when their ID appears in results.AND, OR, NOT are not supported. Use spaces (implicit AND) and - for exclusion.().slack_read_channel for the most recent messages.slack_search_public_and_private when you need to include private channels, but note this requires user consent.testing
Reads a forwarded customer email or ticket, pulls order/refund status from PayPal and account history from HubSpot, drafts a tone-matched reply in the owner's writing voice, and can issue a PayPal refund with explicit owner approval. Use when the user says "draft a response," "answer this customer," "where's my order," or "I want a refund."
development
Prepares tax-season materials for small business owners — framed as deliverables for their accountant, not tax advice. Two modes: (1) quarterly estimated tax calculation — pulls YTD net income from QuickBooks and calculates the federal income tax + self-employment tax liability and quarterly payment due; (2) year-end 1099 prep — scans QuickBooks, PayPal, and Stripe for contractors paid over $600, builds a 1099-NEC candidate list with missing W-9 flags, and produces a plain-English summary a CPA can work from directly. Trigger this skill whenever the user mentions: quarterly taxes, estimated tax payment, how much to set aside for taxes, 1099s, 1099-NEC, year-end tax prep, contractor payments, W-9s, or any phrase suggesting they are preparing for a tax deadline or handing materials to an accountant. Also trigger proactively when a user asks about net profit or YTD income in a context that suggests they are worried about their tax bill.
tools
Prepares tax-season materials — quarterly estimated tax calculation or year-end 1099 prep — and produces an accountant handoff packet. Accepts optional mode and year arguments.
tools
The front door to the Small Business plugin. Listens to what the owner needs right now — vague or specific — and routes them to the best skill or slash command for the moment. Also serves as a guide: explains what's available, suggests what to try next, and adapts recommendations based on stored business context. Trigger whenever the owner asks "what can you do," "help me with my business," "what should I focus on," "I don't know where to start," or any open-ended business request that doesn't clearly match a single skill.