docs(skill/hermes-agent): sync slash commands + add durable-systems section#20390
Merged
Conversation
…ection Mirrors the AGENTS.md #20226 additions (Toolsets / Delegation / Curator / Cron / Kanban) into the user-facing hermes-agent skill, and closes the drift in the in-session slash command list. User report (wxrrior in Discord): the skill did not mention /goal, so a brand-new session answering "/hermes-agent do you have any info on /goal" confidently said it did not exist. Cross-check against the CommandDef registry found 16 commands missing from the static list: /goal, /agents, /busy, /copy, /curator, /debug, /footer, /gquota, /indicator, /kanban, /redraw, /reload, /reload-skills, /snapshot, /steer, /topic. Changes: - Slash Commands header now tells the reader to run /help or check the live docs reference as the source of truth, and names the registry of record (hermes_cli/commands.py) so future drift gets flagged honestly instead of answered confidently wrong. - Added all 16 missing commands, slotted into existing subsections (/goal and /steer in Session; /busy + /indicator + /footer in Configuration; /curator + /kanban + /reload-skills + /reload in Tools & Skills; /topic in Gateway; /copy in Utility; /gquota + /debug in Info). - Toolsets table updated to the authoritative 30-key list from toolsets.py (added kanban, yuanbao, spotify, safe, debugging, video, feishu_doc, feishu_drive, discord, discord_admin, clarify; previously stopped at 20 keys). - New "Durable & Background Systems" section before Troubleshooting covers Delegation, Cron, Curator, Kanban - each with a short rundown of CLI verbs, key invariants, and a pointer to the user-facing docs. Mirrors AGENTS.md #20226 but in the skill's user-facing register. - Bumped version 2.0.0 -> 2.1.0.
alt-glitch
added
type/docs
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sync the
hermes-agentskill with the in-repo slash command registry and the AGENTS.md #20226 additions, so "does/goalexist?" (and anything like it) stops returning a confident wrong answer.Addresses the user report from wxrrior in Discord: on a freshly-updated session, asking
/hermes-agent do you have any info on /goalreturned "no such command" because the skill's static slash-command list hadn't been touched since/goal(and 15 others) landed.Changes
skills/autonomous-ai-agents/hermes-agent/SKILL.md:/help+ the live slash commands reference as the source of truth, and nameshermes_cli/commands.pyas the registry of record. Future drift gets flagged honestly instead of answered confidently wrong./goal,/agents,/busy,/copy,/curator,/debug,/footer,/gquota,/indicator,/kanban,/redraw,/reload,/reload-skills,/snapshot,/steer,/topic.toolsets.py(addedkanban,yuanbao,spotify,safe,debugging,video,feishu_doc,feishu_drive,discord,discord_admin,clarify).Validation
/goalin skillDrift re-check script (
CommandDefnames vs skill's/slashmentions) reports zero registry commands missing after the patch.Note on future drift
Per the Discord thread, the cleanest future-proofing is to have the skill defer entirely to live-generated slash-command text. This PR does the "fix the immediate stale info + point at the live source" half explicitly, without rewriting the skill layout. If we want the stronger version (skill pulls from
/helpoutput directly or regenerates the block at build/install time), I'm happy to do that as a follow-up.