Skip to content

fix(skills): accuracy + concision pass over the hermes-agent hub references - #70511

Merged
teknium1 merged 1 commit into
mainfrom
fix/hermes-agent-skill-accuracy
Jul 24, 2026
Merged

fix(skills): accuracy + concision pass over the hermes-agent hub references#70511
teknium1 merged 1 commit into
mainfrom
fix/hermes-agent-skill-accuracy

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Every hermes-agent skill reference now matches ground truth — audited against COMMAND_REGISTRY, live --help output, the TOOLSETS dict, the 36 shipped provider profiles, and DEFAULT_CONFIG — and the sweep findings from #50608/#50613 are fixed with credit.

Changes

  • references/slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command and the wrong /q alias on /quit (/q = /queue) — first reported by @liuhao1024 (fix(skills): remove phantom slash commands from hermes-agent SKILL.md #50608) and @gauravsaxena1997 (docs: fix hermes-agent skill slash command references #50613). Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, /prompt, /subgoal, …) with verified aliases and CLI/GW scoping.
  • references/cli-reference.md: flags verified against hermes --help (-z/--oneshot, --tui/--cli, --safe-mode, --ignore-rules); subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/auth/webhook/cron/skin/pets taken from argparse; added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup).
  • references/providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (previous table had 21 rows, several stale).
  • references/configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl rows); config-section keys match DEFAULT_CONFIG; STT/TTS provider lists match the shipped set.
  • references/background-systems.md: curator verbs match argparse (usage, list-archived added).
  • Fixed all dangling "see section above/below" references left over from the body split; reset-permissions playbook consolidated in security-privacy.md with a one-line pointer from troubleshooting.
  • Skill version 3.1.0; docs page regenerated.

Validation

Check Result
Slash table vs COMMAND_REGISTRY dump 1:1 (names, aliases, CLI/GW gating)
CLI subcommands vs argparse --help Verified per command
Providers vs list_providers() 36/36, env vars from profile env_vars
Toolsets vs TOOLSETS dict Matched (platform-internal keys excluded)
Routing-table targets + cross-links All resolve, 0 dangling
Description 60 chars

Closes #50608. Closes #50613 (same fix; its source-reading test violates the no-source-in-tests rule and is not carried).

Infographic

hermes-agent-skill-accuracy-pass

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have comp/cli CLI entry point, hermes_cli/, setup wizard tool/skills Skills system (list, view, manage) labels Jul 24, 2026
@github-actions

github-actions Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

૮ >ﻌ< ა ci review

ran on 07feba4

all good!

…rences

Audited every reference against ground truth (COMMAND_REGISTRY, argparse
--help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and
corrected drift the restructure had carried over verbatim:

- slash-commands.md: rebuilt from the live registry. Removes the phantom
  /skill command (never existed — skills load via /skills, hermes -s, or a
  skill's own /<name> command) and the wrong /q alias on /quit (/q belongs
  to /queue) — both reported by @liuhao1024 in #50608 and @gauravsaxena1997
  in #50613. Adds ~25 real commands that were missing (/learn, /memory,
  /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with
  correct aliases and CLI/GW scoping.
- cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode),
  real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/
  auth/webhook/cron/skin/pets, added missing top-level commands (fallback,
  project, moa, logs, console, hooks, security, backup); condensed tables.
- providers-and-models.md: rebuilt from the 36 shipped provider profiles
  with their actual env vars (was 21 rows, several stale); folds in the
  alias system and fallback-chain command.
- configuration.md: toolset table matches TOOLSETS (adds coding,
  computer_use, video_gen, context_engine, project; drops nonexistent
  messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider
  lists match the shipped set.
- background-systems.md: curator verbs match the argparse surface.
- troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed
  dangling 'section above/below' references from the body split; moved the
  reset-permissions playbook to security-privacy.md (its routing home).

Reported-by: liuhao1024 <sunsky.lau@gmail.com>
Reported-by: gauravsaxena1997
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants