mirror of
https://github.com/obra/superpowers
synced 2026-07-31 06:54:31 +00:00
57 lines
1.9 KiB
Markdown
57 lines
1.9 KiB
Markdown
|
# 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.
|