skills.rest
pbc-os
pbc-osCOMMUNITY
Explore all skills by this author →
GitHub

slack-directory

Search Slack users by name with fuzzy matching and cache results.

10|1|Updated Feb 5, 2026
Search Tags:#automation#caching#communication#slack#directory#user lookup
One-click install
npx skills add https://github.com/pbc-os/agent-skills-public --skill slack-directory
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: slack-directory
Source: https://github.com/pbc-os/agent-skills-public/tree/main/skills/tier-2-communication/slack-directory
Command: npx skills add https://github.com/pbc-os/agent-skills-public --skill slack-directory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the common problem of needing a Slack user's ID when you only know their name, which is essential for sending direct messages, mentioning users in channels, or adding them to conversations.

Core Features & Use Cases

  • Fuzzy Name Matching: Searches Slack users by partial first name, last name, display name, or username.
  • Caching: Stores discovered user IDs locally to speed up future lookups for frequently contacted individuals.
  • Use Case: When a colleague asks to "DM Sarah about the new project," this skill can find Sarah Chen's Slack ID (U09ABC123) even if you only provide "Sarah" as the search term.

Quick Start

Use the slack-directory skill to find the Slack user ID for someone named 'Jamie'.

Frequently Asked Questions about slack-directory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a Slack user ID when I only know their name?▼

To find a Slack user ID by name, you can search Slack workspace users using fuzzy matching on first name, last name, display name, or username to retrieve the exact identifier needed.

Do I need a specific Slack bot token scope for user lookup?▼

Yes, performing a Slack user lookup requires a Slack bot token configured with the 'users:read' scope to authorize accessing the workspace directory and returning user identifiers.

Can I search for Slack users by partial name or username?▼

You can search for Slack users by partial name or username because the lookup mechanism applies fuzzy matching to locate individuals even when provided with incomplete or approximate search terms.

What is the best way to automate finding Slack user IDs for direct messaging?▼

Automating Slack user ID discovery for direct messaging involves programmatically querying the directory by name and caching the resulting identifiers locally to optimize future lookup efficiency.

Why does searching Slack users require the jq utility?▼

Searching Slack users requires the jq utility because the script relies on it to parse the JSON responses returned by the Slack API, extracting the relevant user data from the payload.

Are there limitations to caching Slack directory user IDs?▼

A limitation of caching Slack directory user IDs is that the local cache may become outdated if users change their names or leave the workspace, requiring a fresh query to ensure accuracy.

Related Skills

Explore More Content & Communication Skills→
chriswesttchriswestt

slack

List Slack conversations, read messages, and send replies via the Events API.

Community
Intermediate
s1366560s1366560
5

slack-automation

Automate Slack messaging, search, channel management, and reactions via Composio.

Community
Intermediate
0xHoneyJar0xHoneyJar
5

slack

Send, edit, and delete Slack messages via the OpenClaw messaging gateway.

Official
Intermediate
fengtcfengtc

wecom-contact-lookup

Search WeChat enterprise contacts by name or alias via get_userlist.

Community
Basic