slack-gateway-troubleshooting

Diagnose Slack gateway channel enumeration and access reporting failures.

1|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/lucasfth/config --skill slack-gateway-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slack-gateway-troubleshooting
Source: https://github.com/lucasfth/config/tree/main/.hermes/skills/messaging/slack-gateway-troubleshooting
Command: npx skills add https://github.com/lucasfth/config --skill slack-gateway-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes users face intermittent Slack gateway startup issues, missing access reports, and empty channel directories, hindering automated workflows.

Core Features & Use Cases

  • Diagnose gateway startup and channel discovery problems in Slack integration.
  • Provide remediation steps for missing Slack dependencies, restart conflicts, and misconfigured channel discovery across public channels, private channels, DMs, and MPIMs.
  • Outline fast debug flows and implementation notes for live enumeration and fallback to session history.

Quick Start

Run a live process check and verify Slack channel discovery using the gateway.

Frequently Asked Questions about slack-gateway-troubleshooting

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

FAQPage Schema
Why does my Slack gateway show as connected but fails to enumerate channels?

A Slack gateway may appear connected but fail to enumerate channels due to missing Slack dependencies, gateway restart conflicts, or misconfigured channel discovery settings. Diagnosing these requires verifying live enumeration processes and checking channel_directory data structures.

How do I troubleshoot missing public channels, private channels, DMs, and MPIMs in my Slack channel directory?

To troubleshoot missing Slack channels, DMs, and MPIMs, run a live process check to verify gateway startup, validate channel discovery configurations, and align channel_directory data structures with send_message tooling for accurate enumeration.

What is the best way to resolve Slack gateway startup issues and empty channel directories in automated workflows?

Resolving Slack gateway startup issues and empty channel directories involves identifying missing Slack dependencies, addressing restart conflicts, and applying remediation steps for misconfigured channel discovery across public channels, private channels, DMs, and MPIMs.

How do I use session-history fallbacks when live Slack channel enumeration fails?

When live Slack channel enumeration fails, you can fall back to session history to retrieve channel data. This approach ensures continued access reporting and debugging by aligning historical session data with channel_directory structures.

Does Slack gateway troubleshooting require specific dependencies for proper channel discovery?

Yes, proper Slack gateway channel discovery requires specific Slack dependencies to be installed. Missing dependencies can cause the gateway to appear connected while failing to report Slack access or enumerate public channels, private channels, DMs, and MPIMs.

What are common limitations when debugging Slack gateway channel discovery issues?

Common limitations when debugging Slack gateway channel discovery include restart conflicts that disrupt live enumeration, misconfigured discovery settings across channel types, and the need to fall back to session history when real-time channel_directory data is unavailable.