slack-search-user

Search Slack users by username, real name, or display name with cache-first lookup and API fallback.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill slack-search-user
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slack-search-user
Source: https://github.com/djalmaaraujo/claude-code-plugins/tree/main/plugins/slack/skills/slack-search-user
Command: npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill slack-search-user

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Slack user discovery can be slow and rate-limited when searching by username, real name, or display name. This skill maintains a local cache to speed lookups and reduce API usage.

Core Features & Use Cases

  • Automatic status check to ensure Slack is configured
  • Efficient cache lookup using jq for fast results even with large user lists
  • Automatic API fallback and bulk caching of users
  • Cache introspection and questions about cache status (e.g., how many users are cached)

Quick Start

Run a search for a Slack user by providing a username, real name, or display name to locate them quickly.

Frequently Asked Questions about slack-search-user

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

FAQPage Schema
How do I search for Slack users by username or display name without hitting API rate limits?

Search for Slack users using a cache-first approach that checks a local JSON config before falling back to the API. This reduces API usage and speeds up user lookups for DM preparation and mention resolution.

What is the best way to look up Slack workspace contacts for bulk user caching?

Look up Slack contacts using automatic API fallback with bulk caching, which fetches users via API pagination and stores them locally in a JSON config for fast subsequent queries.

Can I find Slack users using partial matching instead of exact names?

Yes, you can find Slack users using both exact and partial matching for usernames, real names, or display names. The skill applies these matching strategies against the local cache before querying the Slack API.

Do I need to configure Slack API settings before searching for users?

Yes, you need Slack API configuration set up before searching. The skill performs an automatic status check to ensure Slack is configured properly and handles configuration errors before attempting user lookups.

Why is my Slack user search slow when querying large workspaces?

Slack user search becomes slow when relying solely on API calls for large workspaces. Using a local cache with efficient jq lookup and API pagination support speeds up results and reduces rate-limit issues.

How do I check how many Slack users are currently cached locally?

Check cached users through cache introspection, which allows you to ask questions about cache status, including how many users are currently stored in the local JSON config file.