Skip to content

docs(cli): remove phantom slash commands - #62933

Closed
jbbottoms wants to merge 1 commit into
NousResearch:mainfrom
jbbottoms:docs/fix-hermes-skill-slash-commands
Closed

docs(cli): remove phantom slash commands#62933
jbbottoms wants to merge 1 commit into
NousResearch:mainfrom
jbbottoms:docs/fix-hermes-skill-slash-commands

Conversation

@jbbottoms

Copy link
Copy Markdown
Contributor

What does this PR do?

The bundled hermes-agent skill documented /skill <name> even though Hermes registers installed skills directly as /<skill-name>. It also listed /q as a quit alias even though the command registry assigns /q to /queue.

This removes the phantom /skill command from the command table, corrects the quit aliases, and updates the troubleshooting section to use the real /<skill-name> syntax.

Related Issue

Fixes #50605

Type of Change

  • 🐛 Bug fix (non-breaking change that fixes an issue)
  • ✨ New feature (non-breaking change that adds functionality)
  • 🔒 Security fix
  • 📝 Documentation update
  • ✅ Tests (adding or improving test coverage)
  • ♻️ Refactor (no behavior change)
  • 🎯 New skill (bundled or hub)

Changes Made

  • Remove /skill <name> from the bundled slash-command table.
  • Change /quit (/exit, /q) to /quit (/exit).
  • Replace the second phantom /skill name example with /<skill-name>.

How to Test

  1. Open skills/autonomous-ai-agents/hermes-agent/SKILL.md.
  2. Confirm the command table contains /skills but does not advertise /skill <name>.
  3. Confirm the exit section lists only /quit and /exit.
  4. Confirm the troubleshooting section recommends /<skill-name> or hermes -s name.

Relevant contract tests:

  • /q queue alias test passed: 1 passed.
  • /quit and /exit behavior tests passed: 6 passed.
  • Installed skill slash-command resolution tests passed: 2 passed.
  • A broader Windows run of tests/agent/test_skill_commands.py produced 48 passed, 2 skipped, and 4 unrelated fixture/cache failures in supporting-file and inline-shell tests.
  • git diff --check passed.

Checklist

Code

  • I've read the Contributing Guide
  • My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
  • I searched for existing PRs to make sure this isn't a duplicate
  • My PR contains only changes related to this fix/feature (no unrelated commits)
  • I've run pytest tests/ -q and all tests pass
  • I've added tests for my changes (required for bug fixes, strongly encouraged for features), or N/A for this documentation-only correction
  • I've tested on my platform: Windows 11

The full Python suite was not run because this changes only bundled Markdown documentation. Existing command and skill-resolution tests were used to verify the documented behavior.

Documentation & Housekeeping

  • I've updated relevant documentation (README, docs/, docstrings), or N/A
  • I've updated cli-config.yaml.example if I added/changed config keys, or N/A
  • I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows, or N/A
  • I've considered cross-platform impact (Windows, macOS) per the compatibility guide, or N/A
  • I've updated tool descriptions/schemas if I changed tool behavior, or N/A

Screenshots / Logs

Not applicable. This corrects bundled command documentation only.

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) duplicate This issue or pull request already exists labels Jul 12, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

This was generated by AI during triage.

Duplicate of #50608 — the earliest-open PR making the same edits to the same file (skills/autonomous-ai-agents/hermes-agent/SKILL.md) for the same issue #50605 (remove the phantom /skill command and correct the /q quit alias). #50613 is already a duplicate of #50608. Keeping this labeled for search/DB consistency; a maintainer picks the canonical PR.

@jbbottoms jbbottoms closed this Jul 12, 2026
@jbbottoms

Copy link
Copy Markdown
Contributor Author

Closing as a duplicate of #50608. Thanks for catching the existing implementation during triage.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

duplicate This issue or pull request already exists 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.

Docs: hermes-agent SKILL.md documents phantom slash commands (/skill, /q)

2 participants