7b177613c0
Rebase of PR #1922 onto current dev: the ~14 files of v6.1.0-era codex/release drift are dropped, the porting-guide edits (stale against the post-prune rewrite, no Hermes content) are dropped, and the Hermes surface is kept intact: .hermes-plugin/ (on_session_start bootstrap injection), tests/hermes/ (20 tests, passing), docs/README.hermes.md, references/hermes-tools.md, the Platform Adaptation row, README section, and Python ignores. Known open items from review, unchanged by this rebase: the injection mechanism uses ctx.inject_message from on_session_start, which the official plugin guide does not document (pre_llm_call returning {"context": ...} is the sanctioned path), skills are not registered via ctx.register_skill, and the acceptance transcript predates the fix. Co-authored-by: kumarabd <kumarabd@users.noreply.github.com>
1.9 KiB
Hermes Agent Tool Mapping
Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Hermes Agent these resolve to the tools below.
Tools
| Action skills request | Hermes tool |
|---|---|
| Read a file | read_file |
| Create a new file | write_file |
| Edit a file (targeted patch) | patch |
| Run a shell command | terminal |
| Search file contents | search_files |
| Find files by name | terminal with find |
| Fetch a URL / read a webpage | web_extract(urls=[...]) |
| Search the web | web_search(query=...) |
| Dispatch a subagent | delegate_task(goal=..., context=..., toolsets=[...], role="leaf") |
| Task tracking | todo tool |
| Invoke a skill | skill_view("skill-name") |
Instructions file
When a skill mentions "your instructions file," on Hermes Agent this is AGENTS.md in the project directory, or SOUL.md globally at ~/.hermes/SOUL.md.
Invoking a skill
Hermes Agent has a skills toolset with skill_view and skills_list tools.
To invoke a superpowers skill, use:
skill_view("brainstorming")
skill_view("test-driven-development")
If skill_view cannot find a superpowers skill (it may not appear in the catalog
until the plugin fully registers it), fall back to reading the SKILL.md directly:
read_file(path="~/.hermes/plugins/superpowers/skills/<skill-name>/SKILL.md")
This fallback is the same mechanism used by other harnesses without native skill loading.
Subagent dispatch
Use delegate_task to spawn isolated subagents for parallel or sequential workstreams:
delegate_task(goal="...", context="...", toolsets=[...], role="leaf")
If delegate_task is unavailable, do the work inline rather than inventing tool calls.
Task tracking
Use the todo tool for task tracking within a session. For multi-agent task boards, use hermes kanban CLI if available. Treat older TodoWrite references as the task-tracking action.