JARVIS UltraManualv1.31

Concepts

Skills

A skill is a set of instructions for a kind of task: how to write the weekly specials post, how to check a supplier invoice, how to use a tool. It is a folder with a SKILL.md file (a name, a one-line description, then the instructions) and sometimes scripts, templates or reference files beside it.

How an agent uses a skill

Each agent sees a list of the skills it has: each skill's name and the first 60 characters of its description. When a task matches, the agent opens the skill and follows it. So the description decides when a skill gets used, and the instructions decide how. Skills cost little until they are used: only the list is in every turn.

Where skills come from

Skills and tools > Skills lists every skill found in any agent's profile, grouped by where it came from:

Group What is in it
Your skills Skills you wrote, imported, or added from Hermes' optional set. You manage these in the dashboard.
Built into Hermes The skills Hermes ships with. Switch them on or off per agent.
System The dashboard's own skills, such as the one agents use to ask for your approval. Always on.
Found in a profile Skills an agent made while it worked, skills added to a profile folder by hand, or skills from Hermes' hub
Hermes' optional skills Extra skills Hermes offers that no agent has yet. Shown when Show Hermes' optional skills is on.

Your skills: write once, sync everywhere

Your own skills live in the dashboard's skill store (data/skills/), not in any one profile. When you publish a version and choose who gets it, the dashboard writes the skill into each chosen agent's profile and locks it there, so the agent cannot change it. When you take a skill away from an agent, or retire it, the dashboard removes that copy.

Your published version always wins. If someone changes an agent's copy by hand, the next sync keeps the changed copy in data/skills/kept/ and puts your version back, and the bell says so. The store keeps the newest 10 versions of each skill, so you can restore an older one.

An agent with an open conversation is told when it gains or loses a skill. When a skill it already has gets a new version, its next turn starts a fresh session so it reads the new text.

Checks before publishing

Every version is checked before it can be published:

  1. The dashboard's own rules: a valid name that no other skill uses, a description, sizes and file types within limits.
  2. A key scan: no line may hold what looks like one of your keys or a well-known key format. The message names the line, never the key.
  3. A tools-lock scan: no file beside SKILL.md may call your connected apps or the dashboard directly, where the tools lock cannot see it.
  4. Hermes' own linter and its guard. The guard gives a verdict of Safe, Caution or Dangerous. Each Caution finding needs your tick, and Dangerous cannot be published.

The checks catch common mistakes; they are not a full security review. Read a skill you import from someone else before you give it to an agent.

See Make and publish a skill and Switch Hermes' skills and tools.