messaging-gateway-troubleshooting

messaging-gateway-troubleshooting is a skill for Claude Code, Codex from AtlasOmnia/donna-starter. It costs 37 tokens per session (1,173 once invoked), scanned A, original, MIT.

A troubleshooting guide for Hermes messaging gateways, which connect an assistant to chat platforms. It helps trace why messages are not received, answered, or filtered.

In plain words
What is it for?
Checking services, listeners, webhooks, health endpoints, adapter connections, logs, sender authorization, and reply-loop safeguards.
Why use it?
It separates connection problems from permission issues and intentional message filtering, so debugging does not start with the wrong assumption.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex.

Good fit Checking services, listeners, webhooks, health endpoints, adapter connections, logs, sender authorization, and reply-loop safeguards.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add AtlasOmnia/donna-starter --skill messaging-gateway-troubleshooting
Clone the repo
git clone --depth 1 https://github.com/AtlasOmnia/donna-starter

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for messaging-gateway-troubleshooting

README.md
[![agentmods](https://agentmods.dev/badge/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting/github.svg)](https://agentmods.dev/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting)
Your own site
<a href="https://agentmods.dev/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting"><img src="https://agentmods.dev/badge/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for messaging-gateway-troubleshooting

Your own site · 80×15
<a href="https://agentmods.dev/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting"><img src="https://agentmods.dev/badge/skills/atlasomnia/donna-starter/messaging-gateway-troubleshooting.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 37 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,173 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00037 $0.01173
Opus 5 $0.00018 $0.00587
Sonnet 5 $0.00007 $0.00235
Haiku 4.5 $0.00004 $0.00117

Measured 11d ago against content hash 8bcb362bf3e1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

messaging-gateway-troubleshooting scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- On macOS, do not assume `localhost` reaches an IPv4-only Hermes webhook. BlueBubbles/Electron/Node may resolve `localhost` to IPv6 `::1`, causing `connect ECONNREFUSED ::1:<port>` while `curl http://127.0.0.1:<port>/he
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/hermes/messaging-gateway-troubleshooting/SKILL.md · 81 lines

How it starts

The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Messaging Gateway Troubleshooting

Use this when Hermes messaging platforms are installed/configured but messages do not arrive, are ignored, do not reply, or appear to risk reply loops.

Operating principles

  1. Verify the live path end to end before assuming config is wrong:
  • Gateway service is running.
  • Platform server/client is running.
  • Local webhook/listener is bound.
  • Health endpoint responds if available.
  • Platform has the webhook registered.
  • Gateway logs show the adapter connected.
  1. Separate transport, authorization, and adapter filtering:
  • Transport failure: no webhook hit / listener closed.
  • Authorization failure: sender not allowed or pairing pending.
  • Adapter filtering: message acknowledged but intentionally skipped, e.g. group mention gating, tapback filtering, or self-message loop guard.
  1. For user-visible claims, verify with real command output: hermes status, listener checks, webhook health, and gateway logs.
  2. When changing Hermes gateway config or adapter code, restart the gateway and verify the adapter reconnects.
  3. For gateway slash-command failures, inspect session-origin scope separately from transport health:
  • Compare source, user_id, chat_id, thread_id, and origin_json in the live session database.
  • Trace both the listing path and the action path; a session browser is still broken if it lists a target that /resume rejects.
  • In forum/threaded platforms, distinguish same-parent-chat ownership from exact-thread isolation rather than weakening origin checks globally.

Telegram forum session browsing

  • A fresh Telegram forum topic can have no prior exact-thread sessions even when the same owner has many titled sessions in sibling topics of the same parent chat.
  • Do not diagnose this from session history alone. Correlate gateway send logs, live DB origin columns, and the gateway routing origin.
  • Cross-topic browsing must be Telegram-specific, same-parent-chat, and same-owner; thread_sessions_per_user=false permits sharing within one thread, not across sibling threads.
  • Keep /sessions visibility and /resume authorization aligned, including persisted-only rows.
  • See references/telegram-forum-session-scope.md for the reproduction, authorization contract, TDD matrix, and safe activation procedure.

Read the full file on GitHub · 81 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 81 lines · 37 tokens per session scan A 8bcb362bf3e1

Subscribe to this mod's changes

messaging-gateway-troubleshooting is a skill published in the GitHub repository AtlasOmnia/donna-starter (111 stars, last pushed 11d ago), licensed MIT. It adds 37 tokens to every session and 1,173 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

messaging-gateway-troubleshooting

Use this when Hermes messaging platforms are installed/configured but messages do not arrive, are ignored, do not reply, or appear to risk reply loops.

AtlasOmnia/hermes-custom-pack · 37 tokens

notebooklm

Install, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API.…

teng-lin/notebooklm-py · 79 tokens

doris-debug-deployment

Use for Doris FE/BE startup failures, port conflicts, prioritynetworks misrouting, metadir corruption, and ADD/DROP BACKEND issues.

apache/doris-skills · 36 tokens

encore-go-logging

Add or improve structured logging in Encore.go using encore.dev/rlog. Covers log placement, levels, stable messages and fields, errors, logging contexts, sensitive data, and log volume.

encoredev/skills · 45 tokens

jsf-query-hooks

Customize JetSmartFilters query arguments and native JSF Listing results without leaking changes across providers or listing instances. Use when adding mandatory constraints, changing postsperpage, filtering listing items, handling a plain query variable, or reviewing jet-smart-filters/listing/render hooks…

Lonsdale201/wp-agent-skills · 80 tokens

awesome-performance-audit

Read-only audit of performance and reliability — event-loop discipline, streaming and backpressure, memory and CPU diagnostics, shutdown/timeout/job habits, resilience topology (circuit breakers, retry budgets, queue bounds), and frontend delivery (Core Web Vitals, bundle size, hydration) — with evidence per finding…

khasky/awesome-agent-skills · 147 tokens