Bug Description

Description

The ticktick productivity skill is installed and visible in my Hermes CLI (hermes skills list), but in a Telegram session the agent reports that the skill does not exist (e.g. Skill 'productivity:ticktick' not found when trying to call it).

So:

• CLI sees the skill and lists it as ticktick (category: productivity, source: local).
• Telegram gateway runs against the same ~/.hermes home and config.
• There are no ticktick-related errors in the Hermes logs.
• In the Telegram session, the skills hub still claims the TickTick skill does not exist.

This looks like a skills-hub / gateway routing bug, not a problem with the skill itself.

Environment

• OS: macOS

• Hermes Home: ~/.hermes

• Gateway process (from ps aux | grep hermes-agent):

  """bash ~/.hermes/hermes-agent/venv/bin/python3 ~/.local/bin/hermes gateway """

• Config file in use:

  """bash ~/.hermes/config.yaml """

• Relevant config sections:

  """yaml model: default: provider:

  toolsets:

  • hermes-cli

  skills: external_dirs: [] enabled: - productivity:ticktick - productivity:time-manager - apple:apple-mail-sender """

What works (CLI)

From the CLI:

"""bash hermes skills list | grep -i ticktick """

Output (excerpt):

"""text │ ticktick │ productivity │ local │ local │ │ time-manager │ productivity │ local │ local │ """

So the skill is correctly installed and registered in the Hermes skills hub for CLI.

What doesn’t work (Telegram gateway)

From a Telegram DM with the agent:

• Any attempt to call or view the TickTick skill (e.g. skill_view("productivity:ticktick") via the tools layer) fails with “Skill not found”.
• The agent cannot call the TickTick tool, even though the skill exists and is enabled.

There are no log entries indicating that the TickTick skill failed to load:

• ~/.hermes/logs/agent.log and ~/.hermes/logs/errors.log contain:
  • my Telegram messages mentioning "ticktick" (as user text),
• but there is no Failed to load skill ticktick, ModuleNotFoundError, or any stack trace that mentions the TickTick skill itself.

This suggests:

• The TickTick skill is installed and discoverable by the global skills hub.
• The Telegram gateway / skills-hub integration for this platform/session is not surfacing that skill to the model.
• It feels related in spirit to #4759 and #13534, but in reverse: the skill exists and is usable in one environment (CLI), but is effectively invisible to another (Telegram gateway), even though they share the same ~/.hermes home.

Steps to Reproduce

On a macOS machine with Hermes installed:

1. Install the ticktick productivity skill under:

   """text ~/.hermes/skills/productivity/ticktick """

2. Enable it in ~/.hermes/config.yaml:

   """yaml skills: external_dirs: [] enabled: - productivity:ticktick """

3. Start the Hermes gateway for Telegram, e.g.:

   """bash ~/.hermes/hermes-agent/venv/bin/python3 ~/.local/bin/hermes gateway """

4. From the CLI, run:

   """bash hermes skills list """

   and confirm you see:

   """text ticktick │ productivity │ local │ local """

5. From Telegram (same user, same machine, same Hermes home), send a message that triggers the agent to call the TickTick skill (e.g. ask it to create a TickTick task or explicitly use skill_view("productivity:ticktick")).

6. Observe that:

   • The agent responds as if the skill does not exist (e.g. "Skill 'productivity:ticktick' not found").
   • No ticktick-related error is logged in ~/.hermes/logs/agent.log or errors.log.

Expected Behavior

• Any skill that is visible in hermes skills list and enabled in skills.enabled should also be available to the Telegram gateway via the skills hub.
• The model should be able to call the TickTick skill from Telegram, or at least:
  • if loading the skill fails, there should be a clear error in the logs referencing the TickTick skill (import error, dependency issue, etc.).

Actual Behavior

• CLI: TickTick is present and listed as an installed local productivity skill.
• Telegram gateway:
  • The model’s tool layer reports “Skill not found” when trying to use the TickTick skill.
  • Logs do not show any TickTick load failure.

Question / Request

• Is there a known issue where the Telegram gateway / skills hub doesn’t surface all enabled skills to the model, even though hermes skills list shows them?
• Are there additional configuration steps required so that the Telegram gateway uses the same skills hub configuration as the CLI?
• Any debugging guidance (e.g. extra logging flags for skills hub discovery in the gateway) would be appreciated.

Thanks!

Steps to Reproduce

Minimal steps to trigger the bug:

1. Install Hermes and ensure it uses ~/.hermes as home.

2. Install the ticktick skill under ~/.hermes/skills/productivity/ticktick.

3. Enable it in ~/.hermes/config.yaml:

   skills:
     external_dirs: []
     enabled:
       - productivity:ticktick

4. Start the gateway that serves Telegram:

   ~/.hermes/hermes-agent/venv/bin/python3 ~/.local/bin/hermes gateway

5. In the CLI, run:

   hermes skills list | grep -i ticktick

   and confirm ticktick appears as an installed local productivity skill.

6. From Telegram (same machine/user, same Hermes home), ask the agent to use the TickTick skill (e.g. "create a task in TickTick" or trigger skill_view("productivity:ticktick") via tools).

7. Observe that the agent responds as if the skill does not exist ("Skill 'productivity:ticktick' not found"), while no ticktick-related error appears in ~/.hermes/logs/agent.log or errors.log.

Expected Behavior

The TickTick skill should be available in the Telegram gateway just like in the CLI:

• Any skill that is visible in hermes skills list and enabled in skills.enabled should also be exposed to the Telegram gateway via the skills hub.
• From Telegram, the agent should be able to call the TickTick skill (e.g. create tasks via the TickTick API) without returning “Skill not found”.
• If the skill fails to load for some reason, there should be a clear error in the logs referencing the TickTick skill (e.g. import error, dependency issue), instead of silently appearing as non‑existent.

Actual Behavior

• In the CLI, the ticktick skill appears in hermes skills list as an installed local productivity skill and looks correctly registered.
• In the Telegram gateway, any attempt to use or view the TickTick skill (e.g. asking the agent to create a TickTick task or calling skill_view("productivity:ticktick")) results in the agent responding as if the skill does not exist (e.g. “Skill 'productivity:ticktick' not found”).
• There are no TickTick-related errors in ~/.hermes/logs/agent.log or ~/.hermes/logs/errors.log – only my user messages mentioning “ticktick”, but no “Failed to load skill ticktick”, no ModuleNotFoundError, and no stack trace related to the TickTick skill.

Affected Component

Skills (skill loading, skill hub, skill guard)

Messaging Platform (if gateway-related)

Telegram

Debug Report

--- hermes dump ---
version:          0.9.0 (2026.4.13) [da8bab77]
os:               Darwin 25.4.0 arm64
python:           3.11.15
openai_sdk:       2.31.0
profile:          default
hermes_home:      ~/.hermes
model:            
provider:         
terminal:         local

api_keys:
  openrouter           set
  openai               set
  anthropic            set
  kimi                 set
  fal                  set

features:
  toolsets:           hermes-cli
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            not loaded
  platforms:          telegram
  cron_jobs:          2 active / 2 total
  skills:             98

config_overrides:
  agent.max_turns: 60
  display.streaming: True
  tts.provider: openai
--- end dump ---

--- agent.log (last 200 lines) ---
[snipped for brevity – mostly recent Telegram messages and a 401 Unauthorized error for vision (openai AuthenticationError)]

Operating System

macOS 15.2

Python Version

Python 3.14.3

Hermes Version

Hermes Agent v0.9.0

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

• I'd like to fix this myself and submit a PR