Skills › Superpowers › using-superpowers › hermes-tools.md

hermes-tools.md

56 lines · skills/using-superpowers/references/hermes-tools.md at 2ce8aa1

Starts an agent Project instruction file Names a skill

Most marks come from matching words in the file, so treat them as pointers.

1# Hermes Agent Tool Mapping

3Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Hermes Agent these resolve to the tools below.

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.

Raw lines 1 to 4

Starts an agent Agent Tool :1

Starts an agent dispatch :3

Starts an agent subagent :3

5## Tools

7| Action skills request | Hermes tool |

8|---|---|

9| Read a file | `read_file` |

10| Create a new file | `write_file` |

11| Edit a file (targeted patch) | `patch` |

12| Run a shell command | `terminal` |

13| Search file contents | `search_files` |

14| Find files by name | `terminal` with `find` |

15| Fetch a URL / read a webpage | `web_extract(urls=[...])` |

16| Search the web | `web_search(query=...)` |

17| Dispatch a subagent | `delegate_task(goal=..., context=..., toolsets=[...], role="leaf")` |

18| Task tracking | `todo` tool |

19| Invoke a skill | `skill_view("skill-name")` |

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")`

Raw lines 5 to 20

Starts an agent Dispatch :17

Starts an agent subagent :17

21## Instructions file

23When 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`.

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.

Raw lines 21 to 24

Project instruction file AGENTS.md :23

25## Invoking a skill

27Hermes Agent has a `skills` toolset with `skill_view` and `skills_list` tools.

28To invoke a superpowers skill, use:

30```

31skill_view("brainstorming")

32skill_view("test-driven-development")

33```

35If `skill_view` cannot find a superpowers skill (it may not appear in the catalog

36until the plugin fully registers it), fall back to reading the SKILL.md directly:

38```

39read_file(path="~/.hermes/plugins/superpowers/skills/<skill-name>/SKILL.md")

40```

42This fallback is the same mechanism used by other harnesses without native skill loading.

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.

Raw lines 25 to 43

Names a skill brainstorming :31

Names a skill test-driven-development :32

44## Subagent dispatch

46Use `delegate_task` to spawn isolated subagents for parallel or sequential workstreams:

48```

49delegate_task(goal="...", context="...", toolsets=[...], role="leaf")

50```

52If `delegate_task` is unavailable, do the work inline rather than inventing tool calls.

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.

Raw lines 44 to 53

Starts an agent Subagent :44

Starts an agent dispatch :44

Starts an agent spawn :46

Starts an agent subagents :46

54## Task tracking

56Use 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.

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.

Raw lines 54 to 56