Generated banner for Slack Search
Generated logo for Slack Search

Slack Search

AnthropicOfficialCreated by SalesforceDistributed by Anthropic

  • Skill
  • Guidelines
  • Automation and integrations
  • MIT
  • No issues found

From the author

Guidance for effectively searching Slack to find messages, files, channels, and people
— the description by Salesforce

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to searching within Slack, detailing effective strategies, search modifiers, and tool usage. It helps users navigate Slack's search syntax to find specific information, manage search scope, and handle search results efficiently. The guide covers keyword strategies, location and content filters, date-based searching, and file-specific queries, while also highlighting common pitfalls like unsupported boolean operators.

What it does

  • Explains how to use search modifiers for location, users, content, and dates.
  • Provides strategies for refining search results from broad queries to specific findings.
  • Outlines the use of specific search tools for public versus private channel access.
  • Details how to search for specific file types like PDFs, images, and spreadsheets.
  • Offers guidance on following up search results with thread and channel reading tools.
  • Identifies common search limitations such as the lack of boolean operators.

When to use it

  • When you need to locate specific messages, files, or conversations within Slack.
  • When you need to gather context from past discussions to answer a user question.
  • When you need to identify specific users or channels based on roles or names.
  • When initial search attempts return too many or too few results.

Advantages

  • Improves search precision by using specific modifiers instead of generic keywords.
  • Helps manage access requirements for searching private channels and DMs.
  • Reduces time spent manually scrolling through channels by using targeted filters.
  • Provides a clear methodology for breaking down complex information requests.

Usage examples

“Find the PDF budget document from January 2025.”
The agent will use the file search parameters with the 'type:pdfs' filter and date range to locate the specific document.
“What did Sarah say about the project deadline in the marketing channel?”
The agent will use 'from:sarah' and 'in:marketing' filters to isolate relevant messages.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/anthropics/slack-search/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip slack-search.zip -d .agents/skills

Documentation by Salesforce

This skill provides guidance for effectively searching Slack to find messages, files, and information.

When to Use

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.

Search Tools Overview

ToolUse When
slack_search_publicSearching public channels only. Does not require user consent.
slack_search_public_and_privateSearching all channels including private, DMs, and group DMs. Requires user consent.
slack_search_channelsFinding channels by name or description.
slack_search_usersFinding people by name, email, or role.

Search Strategy

Start Broad, Then Narrow
  1. Begin with a simple keyword or natural language question.

  2. If too many results, add filters (in:, from:, date ranges).

  3. If too few results, remove filters and try synonyms or related terms.

Choose the Right Search Mode
  • Natural language questions (e.g., "What is the deadline for project X?") — Best for fuzzy, conceptual searches where you don't know exact keywords.

  • Keyword search (e.g., project X deadline) — Best for finding specific, exact content.

Use Multiple Searches

Don't rely on a single search. Break complex questions into smaller searches:

  • Search for the topic first

  • Then search for specific people's contributions

  • Then search in specific channels

Search Modifiers Reference

Location Filters
  • in:channel-name — Search within a specific channel

  • in:<#C123456> — Search in channel by ID

  • -in:channel-name — Exclude a channel

  • in:<@U123456> — Search in DMs with a user

User Filters
  • from:<@U123456> — Messages from a specific user (by ID)

  • from:username — Messages from a user (by Slack username)

  • to:me — Messages sent directly to you

Content Filters
  • is:thread — Only threaded messages

  • has:pin — Pinned messages

  • has:link — Messages containing links

  • has:file — Messages with file attachments

  • has::emoji: — Messages with a specific reaction

Date Filters
  • before:YYYY-MM-DD — Messages before a date

  • after:YYYY-MM-DD — Messages after a date

  • on:YYYY-MM-DD — Messages on a specific date

  • during:month — Messages during a specific month (e.g., during:january)

Text Matching
  • "exact phrase" — Match an exact phrase

  • -word — Exclude messages containing a word

  • wild* — Wildcard matching (minimum 3 characters before *)

To search for files, use the content_types="files" parameter with type filters:

  • type:images — Image files

  • type:documents — Document files

  • type:pdfs — PDF files

  • type:spreadsheets — Spreadsheet files

  • type:canvases — Slack Canvases

Example: content_types="files" type:pdfs budget after:2025-01-01

Following Up on Results

After finding relevant messages:

  • Use slack_read_thread to get the full thread context for any threaded message.

  • Use slack_read_channel with oldest/latest timestamps to read surrounding messages for context.

  • Use slack_read_user_profile to identify who a user is when their ID appears in results.

Common Pitfalls

  • Boolean operators don't work. AND, OR, NOT are not supported. Use spaces (implicit AND) and - for exclusion.

  • Parentheses don't work. Don't try to group search terms with ().

  • Search is not real-time. Very recent messages (last few seconds) may not appear in search results. Use slack_read_channel for the most recent messages.

  • Private channel access. Use slack_search_public_and_private when you need to include private channels, but note this requires user consent.

Files

SKILL.md

This skill provides guidance for effectively searching Slack to find messages, files, and information.

When to Use

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.

Search Tools Overview

ToolUse When
slack_search_publicSearching public channels only. Does not require user consent.
slack_search_public_and_privateSearching all channels including private, DMs, and group DMs. Requires user consent.
slack_search_channelsFinding channels by name or description.
slack_search_usersFinding people by name, email, or role.

Search Strategy

Start Broad, Then Narrow
  1. Begin with a simple keyword or natural language question.

  2. If too many results, add filters (in:, from:, date ranges).

  3. If too few results, remove filters and try synonyms or related terms.

Choose the Right Search Mode
  • Natural language questions (e.g., "What is the deadline for project X?") — Best for fuzzy, conceptual searches where you don't know exact keywords.

  • Keyword search (e.g., project X deadline) — Best for finding specific, exact content.

Use Multiple Searches

Don't rely on a single search. Break complex questions into smaller searches:

  • Search for the topic first

  • Then search for specific people's contributions

  • Then search in specific channels

Search Modifiers Reference

Location Filters
  • in:channel-name — Search within a specific channel

  • in:<#C123456> — Search in channel by ID

  • -in:channel-name — Exclude a channel

  • in:<@U123456> — Search in DMs with a user

User Filters
  • from:<@U123456> — Messages from a specific user (by ID)

  • from:username — Messages from a user (by Slack username)

  • to:me — Messages sent directly to you

Content Filters
  • is:thread — Only threaded messages

  • has:pin — Pinned messages

  • has:link — Messages containing links

  • has:file — Messages with file attachments

  • has::emoji: — Messages with a specific reaction

Date Filters
  • before:YYYY-MM-DD — Messages before a date

  • after:YYYY-MM-DD — Messages after a date

  • on:YYYY-MM-DD — Messages on a specific date

  • during:month — Messages during a specific month (e.g., during:january)

Text Matching
  • "exact phrase" — Match an exact phrase

  • -word — Exclude messages containing a word

  • wild* — Wildcard matching (minimum 3 characters before *)

To search for files, use the content_types="files" parameter with type filters:

  • type:images — Image files

  • type:documents — Document files

  • type:pdfs — PDF files

  • type:spreadsheets — Spreadsheet files

  • type:canvases — Slack Canvases

Example: content_types="files" type:pdfs budget after:2025-01-01

Following Up on Results

After finding relevant messages:

  • Use slack_read_thread to get the full thread context for any threaded message.

  • Use slack_read_channel with oldest/latest timestamps to read surrounding messages for context.

  • Use slack_read_user_profile to identify who a user is when their ID appears in results.

Common Pitfalls

  • Boolean operators don't work. AND, OR, NOT are not supported. Use spaces (implicit AND) and - for exclusion.

  • Parentheses don't work. Don't try to group search terms with ().

  • Search is not real-time. Very recent messages (last few seconds) may not appear in search results. Use slack_read_channel for the most recent messages.

  • Private channel access. Use slack_search_public_and_private when you need to include private channels, but note this requires user consent.

Requirements and compatibility

Written for: Claude Code, Claude apps

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Salesforce
Publisher
Anthropic (Official)
Distributed by
Anthropic
Source
anthropics/knowledge-work-plugins · partner-built/slack/skills/slack-search · commit e050c2e
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from partner-built/slack/LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Salesforce or Anthropic.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download slack-search.zip