# Skills system and persistent memory

> Procedural skills + durable memory are Hermes’ closed learning loop — learn to steer them.

Canonical: https://www.brainyxai.co.za/education/hermes/skills-and-memory
Markdown: https://www.brainyxai.co.za/md/education/hermes/skills-and-memory.md
Course: Hermes Agent Operator Track
Lesson: 6 of 9
Minutes: 20
Author: Brainyx AI

## What you will be able to do

- Describe skills as on-demand procedural knowledge
- Explain why memory nudges matter
- Plan a simple skill you want Hermes to maintain

## Skills = reusable procedures

Hermes **skills** are on-demand knowledge documents with progressive disclosure — the agent doesn’t load every skill into every prompt. Skills can be agent-managed, improved during use, and shared via the Skills Hub / [agentskills.io](https://agentskills.io)-compatible formats.

Primary docs:

- [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)
- [Curator](https://hermes-agent.nousresearch.com/docs/user-guide/features/curator) — background maintenance for agent-created skills

### Operator practice

Good skill topics: deploy checklist for *your* stack, “how we triage support tickets”, “blog publish steps”. Bad skill topics: secrets, one-off chat noise, unverified procedures.

Ask Hermes to **draft a skill** after a successful multi-step task, then edit it yourself. Human curation beats blind accumulation.

## Persistent memory

[Persistent Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) is how Hermes remembers across sessions — preferences, project facts, corrected mistakes. Optional providers and Honcho-style dialectic modeling extend this ([Memory Providers](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers), [Honcho](https://hermes-agent.nousresearch.com/docs/user-guide/features/honcho)).

### Steer the loop

- Correct wrong memories immediately
- Prefer durable facts (“deploy via GitHub Actions”) over ephemeral ones (“today’s meeting moved”)
- Don’t store credentials in memory

## Context files vs memory vs skills

| Mechanism | Best for |
| --- | --- |
| Context files | Project/repo standing instructions |
| Memory | Cross-session user/project facts |
| Skills | Step-by-step procedures Hermes can load on demand |

Use all three deliberately; don’t dump everything into one SOUL.md.

## Learning loop lab

1. Complete a 3+ step task successfully with Hermes.
2. Ask it to propose a skill document for that procedure; edit and save per the skills docs.
3. Tell Hermes one durable preference to remember; start a new session and check it recalls correctly.

## Checkpoints

- I can separate skills, memory, and context files
- I curate skills instead of hoarding them

## What makes a skill worth maintaining

A skill is procedural knowledge the agent loads when relevant — the how of a task, captured once. That only pays off under specific conditions.

Good candidates repeat often, have a stable procedure, and currently require you to re-explain context every time. Weekly reporting with a fixed shape, a client onboarding sequence, a recurring reconciliation — these earn their maintenance cost.

Poor candidates are one-offs, procedures that change every time you run them, or tasks where the hard part is judgment rather than steps. Encoding judgment as procedure produces confident execution of the wrong approach.

## Writing skills that hold up

Treat a skill like a runbook for a competent new colleague. State the trigger condition, the inputs it needs, the steps in order, the checks that prove it worked, and what to do when a step fails.

The failure branch is the part people omit and the part that determines whether a skill is safe to run unattended. A skill that only describes the happy path will improvise when reality differs, and improvisation is exactly what you were trying to remove.

## Memory hygiene as a practice

Memory degrades in a specific way: it accumulates facts that were true when stored. A former client, a superseded process, a preference you changed. The agent has no way to know these expired, so it keeps applying them with full confidence.

Review periodically with one question per entry — if this shaped an output next month, would that be correct? Remove anything that fails. Prefer storing decisions with their reasoning over storing raw statements, because reasoning lets you judge whether it still applies.

## Nudges and the interruption budget

Surfacing relevant memory unprompted is genuinely useful and easy to overdo. An agent that interjects constantly gets ignored, which defeats the point. Tune toward fewer, higher-confidence surfacings; the value is in the one reminder that mattered, not in volume.

## SA business application

The highest-value skills in a small South African business are usually the undocumented procedures living in one person's head — how quotes get built, how a supplier dispute is escalated, what has to happen before month-end. Encoding those has value beyond the agent: writing the skill forces the documentation nobody has done.

If those procedures are worth encoding for one person, they are usually worth building as [workflow automation](https://www.brainyxai.co.za/services/ai-automation) for the team.

## Mini-FAQ

**Q: Skill or just a good prompt?**
A: Prompt for a one-off. Skill when you would otherwise write that prompt again next week with the same context.

**Q: How often should I prune memory?**
A: Monthly for active use, or whenever you notice it referencing something stale. Once wrong facts compound, cleanup is harder.

**Q: Can skills call tools?**
A: Yes, which is why the tool tiering from the previous lesson applies to skills too — a skill is only as safe as the tools it invokes.

## Next lesson

Continue to [the messaging gateway](https://www.brainyxai.co.za/education/hermes/messaging-gateway).

Official reference: https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

Course hub: https://www.brainyxai.co.za/education/hermes · Previous: https://www.brainyxai.co.za/education/hermes/tools-and-backends · Next: https://www.brainyxai.co.za/education/hermes/messaging-gateway