Tutorials

Hermes Agent Skills: Install, Inspect, Edit, and Verify

To install a Hermes Agent skill on Lobsterland, open your running instance’s Skills tab, paste the complete Hub reference, and select Install. Then open its SKILL.md and test the skill in a fresh chat. Keep the source and category in the reference: they identify what you are installing.

  1. Choose: find a skill and copy its complete installation reference.
  2. Install: submit that reference in the Skills tab.
  3. Inspect: open the installed file and read its instructions.
  4. Verify: ask Hermes to use it on one small task, then check the result.

What does a Hermes skill installation actually add?

A skill gives Hermes a reusable set of instructions. Its main file is SKILL.md; a skill can also include supporting material. Hermes can load the instructions when a task needs them. This guide concerns the Hermes Agent runtime, not the Hermes language-model family.

There are three separate checks: the file exists, the agent reads it, and the result follows it. A successful file installation establishes the first. It does not prove the other two. A procedure for working with a service also needs the appropriate tools and access; copying its instructions does not supply an account or an API credential.

On Lobsterland, the Skills tab reads the instance’s /opt/data/skills directory. That directory is on the instance’s persistent storage, alongside Hermes’s own state. The editor works on the actual skill file, so you can inspect what the agent is being asked to follow.

Which skill reference should you paste?

Use the complete identifier from the skill’s source. Official optional skills use this shape:

official/<category>/<skill>

For example, the official optional-skills catalog includes official/communication/one-three-one-rule, an instruction skill for structuring a decision brief. On September 10, 2026, we installed that exact reference with Lobsterland’s generated install command in our local Hermes v2026.8.31 image and verified the resulting file. We did not run a model task or benchmark its output.

Do not shorten a reference just because its last component looks like the skill name. The full path tells the installer which source you intended. Catalog entries vary by runtime version; use a reference available to your instance rather than assuming every example in a tutorial still exists in every image.

The Hermes Skills System reference also documents installation from HTTP(S) URLs and other source adapters. A URL is an identifier, too. In the hosted field, paste the reference itself, without a shell command or flags. Check the skill’s instructions and source before installing third-party material; hosting does not make those instructions trustworthy.

How do you install and inspect a skill on Lobsterland?

  1. Open your running Hermes instance. Choose Skills in the instance navigation. Check that you selected the intended instance before changing its library.
  2. Find “Install from Hermes Hub.” Paste the complete reference into Skill name or reference, then select Install.
  3. Check “Installed skills.” The list refreshes after installation. For the verified example, look for communication/one-three-one-rule. Use Load more if the library extends beyond the displayed entries.
  4. Open the file. Select the entry to read its SKILL.md. Confirm that its description and instructions match the source and task you chose.

The installed path need not repeat the source prefix. In our verified example, official/ selected the source, while the file appeared under communication/one-three-one-rule/SKILL.md. Distinguish the identifier used to fetch a skill from the path used to edit it afterward.

Keep the file check even when you see an installation confirmation. If the expected entry is absent, do not assume it is ready or repeatedly submit shorter names. Recheck the complete reference, refresh the list, and inspect the instance logs or contact support with the reference and the visible error. Leave credentials out of that report.

What are the equivalent Hermes CLI commands?

If you operate your own Hermes environment, the corresponding install and list commands for the verified example are:

hermes skills install official/communication/one-three-one-rule
hermes skills list

Run these in the environment that owns the agent’s state. Installing into a laptop’s Hermes home will not update a separate hosted instance. The CLI is useful when you want direct access to source inspection and runtime-specific options; the Lobsterland Skills tab handles the managed instance’s files without requiring a server shell.

For command details and session behavior, see the official Working with Skills guide. After installing, start a fresh conversation before testing discovery. Ask Hermes by name to read and use the skill; this also makes your test clearer than hoping it selects the right instructions from an unrelated request.

How do you edit a skill and check that it was used?

Select the installed entry, edit the text, and choose Save. Revert discards unsaved edits; it is not a history browser or a way to recover an earlier saved version. Keep a copy of an important original before changing it.

Make one change with an observable result. For a decision-brief skill, you might add a requirement to name the main uncertainty in its recommendation. Then use a deliberately small test prompt:

Read the one-three-one-rule skill and use it to compare
three ways to organize my personal reading notes.
Keep the recommendation short and name its main uncertainty.

This is a suggested verification task, not a claim about a result we measured. Check the visible answer for the requested structure, actual differences between the options, and the uncertainty you added. If your interface shows tool activity, look for the skill being read. A statement such as “I used the skill” alone is weaker evidence than the file-read activity and an answer that follows its specific instructions.

Hermes can revise skills it authors. The hosted editor explicitly warns that manual edits can be overwritten. If a rule matters for repeated work, inspect the file again after the agent revises its procedure. Avoid editing while asking the agent to rewrite the same skill.

The hosted Hermes list has no per-skill upgrade button. Its editing controls are not a promise of automatic upstream updates. Treat refreshing source content and editing your local instructions as different operations, and preserve custom changes before replacing them.

Why is an installed Hermes skill not doing what you expected?

What you seeWhat to check next
No expected entry in Installed skillsCheck the complete source reference, available catalog for your version, list pagination, and install errors.
The file exists, but the reply ignores itStart a fresh chat and explicitly ask Hermes to read the named skill before doing the task.
The procedure calls for an unavailable toolInspect its prerequisites. Installing instructions does not add the tool or grant service access.
Your saved change disappearsCheck whether the agent rewrote the skill. Compare against the copy you kept.
You cannot find an upgrade controlThe hosted Hermes Skills tab does not provide one. Save and Revert apply to editing, not upstream updates.

If the error concerns a memory write rather than a skill file, use the separate Hermes memory-limit troubleshooting guide. Reinstalling a skill is not a diagnosis for a memory-store error.

When does managed hosting help with Hermes skills?

The practical benefit is keeping the agent’s library with its running instance and being able to inspect and edit it through the dashboard. You still choose the procedure, review its instructions, supply any required access, and judge its output.

Choose managed Hermes Agent hosting if you want that instance and its Skills editor without maintaining a server. Self-hosting gives you direct control over the environment and the full CLI. If you are still choosing a runtime, the OpenClaw and Hermes comparison explains their hosted surfaces.

Questions about installing Hermes skills

Where are Hermes skills stored on Lobsterland?

The Skills tab reads /opt/data/skills on the instance’s persistent storage. Selecting an installed entry opens its SKILL.md file.

Should I paste the skill name or its full Hub reference?

Use the complete reference provided by the source. Keep its source and category components; paste only the reference, not a shell command or flags.

Does installing a skill prove that Hermes will use it?

No. Check that the file exists, then ask Hermes to read and use the named skill in a fresh chat. Inspect the result against the instructions.

Can I upgrade a Hermes skill from the Lobsterland Skills tab?

The hosted Hermes Skills tab has no per-skill upgrade button. Save and Revert concern editing; they do not fetch upstream versions.

Can Hermes overwrite my manual skill edits?

Hermes can revise skills it authors, and the editor warns that manual edits can be overwritten. Keep a copy of important instructions and inspect the file after agent revisions.

Keep your skills with a managed Hermes instance. Choose Hermes when creating your instance, then open its Skills tab.

Start a Hermes instance See hosting costs

Cookie preferences