Nous Research Adds /learn to Hermes Agent’s Skills System, Capturing Workflows as Slash Commands Without Hand-Writing SKILL.md

Nous Research has expanded the Skills System inside Hermes Agent, its open-source self-improving agent. The new addition is /learn, a command that writes a reusable skill for you. Point it at a document page, a local SDK, a past conversation, or pasted notes. The live agent gathers the material, then authors a SKILL.md on your behalf. Hermes Agent can now /learn from anything: feed it directories of any source material (code, API docs, manuals, PDFs, configs) and it distills a verifiable reusable skill pic.twitter.com/oRznwCRF3E— Nous Research (@NousResearch) June 23, 2026 Hermes Skills System Skills are on-demand knowledge documents the agent loads when needed. Each one is a folder containing a SKILL.md file with instructions. They follow a progressive disclosure pattern to keep token usage low. The format is compatible with the agentskills.io open standard. All skills live in ~/.hermes/skills/, the single source of truth. On a fresh install, bundled skills are copied from the repo. Hub-installed and agent-created skills land there too. Every installed skill becomes a slash command automatically. Running /plan or /axolotl loads that skill’s instructions into the turn. Think of a skill as a reference document the agent reads only when relevant. Memory, by contrast, holds small durable facts that should always stay in context. How /learn Works /learn removes the hand-writing step. You describe a source, and the agent does the sourcing with tools it already has. It reads local directories with read_file and search_files. It fetches online docs with web_extract. It can also capture a workflow you just walked it through. Copy CodeCopiedUse a different Browser# A local SDK or doc directory /learn the REST client in ~/projects/acme-sdk, focus on auth + pagination # An online doc page /learn https://docs.example.com/api/quickstart # The workflow you just completed in this conversation /learn how I just deployed the staging server # Pasted notes or a described procedure /learn filing an expense: open the portal, New > Expense, attach receipt, submit The agent then authors a skill that follows the house authoring standards. That means a description under 60 characters, the standard section order, and Hermes-tool framing. It does not invent commands that do not exist. There is no separate ingestion engine. /learn builds a standards-guided prompt and hands it to the agent as a normal turn. So it works the same in the CLI, the messaging gateway, the TUI, and the dashboard. It also works on any terminal backend, whether local, Docker, or remote. The dashboard adds a Learn a skill button with a directory field, a URL field, and a text box. The agent saves the result with the skill_manage tool. If you have the write-approval gate on, that approval step still applies. Why Skills Stay Cheap Skills load in three levels, so the agent pays only for what it uses. LevelCallReturnsApprox. cost0skills_list()Names, descriptions, categories~3k tokens1skill_view(name)Full content plus metadataVaries2skill_view(name, path)A specific reference fileVaries The agent sees a compact index at all times. It loads full skill content only when a task needs it. This keeps a large skill library from flooding the context window. Four Ways to Create a Skill /learn is one path among several. The right choice depends on who authors the skill and where the source lives. MethodWho authorsSource inputReview gateBest forHand-write SKILL.mdYouYour own knowledgeNoneFull control over wording/learnThe live agentDir, URL, conversation, notesskill_manage gateTurning existing material into a skill fastskill_manage (auto)The agent itselfA workflow it just solvedwrite_approval gateCapturing procedural memory after hard tasksSkills Hub installA third partyRegistry or GitHub repoSecurity scannerReusing community or vendor skills Agent-created skills are the agent’s procedural memory. The agent may save an approach after a complex task of five or more tool calls. It also saves when it hit a dead end and found the working path. By default, write_approval is false, so the agent writes freely. Set it to true to stage every write for review under ~/.hermes/pending/skills/. Use Cases With Examples Onboarding an internal API: Run /learn on your private docs URL. The agent produces a skill covering auth, pagination, and common calls. New teammates then invoke it as a slash command. Capturing a deploy runbook: Walk the agent through one staging deploy. Then run /learn how I just deployed the staging server. The procedure becomes repeatable across the CLI and chat platforms. Grouping a recurring task: Use a skill bundle to load several skills at once. One slash command then pulls in review, test, and PR skills together. Copy CodeCopiedUse a different Browser# ~/.hermes/skill-bundles/backend-dev.yaml name: backend-dev description: Backend feature work — review, test, PR workflow. skills: - github-code-review - test-driven-development - github-pr-workflow instruction: | Always start by writing failing tests, then implement. A Look at the SKILL.md Format A skill is mostly a markdown file with YAML frontmatter. The body follows a fixed section order. /learn targets this exact shape so output stays consistent. Copy CodeCopiedUse a different Browser--- name: my-skill description: Brief description of what this skill does version: 1.0.0 platforms: [macos, linux] # Optional — restrict to specific OS metadata: hermes: tags: [python, automation] category: devops --- # Skill Title ## When to Use Trigger conditions for this skill. ## Procedure 1. Step one 2. Step two ## Pitfalls - Known failure modes and fixes ## Verification How to confirm it worked. The platforms field can hide a skill on incompatible operating systems. Conditional fields can also show a skill only when certain toolsets are present or absent. Interactive Explainer Local directory&lt;/div&gt; &lt;div class=&quot;tab&quot; data-src=&quot;url&quot;&gt;<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f517.png" alt="🔗" class="wp-smiley" style="height: 1em; max-height: 1em;" /> Doc URL&lt;/div&gt; &lt;div class=&quot;tab&quot; data-src=&quot;conv&quot;&gt;<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f4ac.png" alt="💬" class="wp-smiley" style="height: 1em; max-height: 1em;" /> Conversation&lt;/div&gt; &lt;div class=&quot;tab&quot; data-src=&quot;notes&quot;&gt;<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f4dd.png" alt="📝" class="wp-smiley" style="height: 1em; max-height: 1em;" /> Pasted notes&lt;/div&gt; &lt;/div&gt; &lt;div class=&quot;row&quot;&gt; &lt;div&gt; &lt;label&gt;Skill name (slug)&lt;/label&gt; &lt;input id=&quot;hl-name&quot; value=&quot;acme-api&quot; maxlength=&quot;40&quot; placeholder=&quot;lowercase-with-hyphens&quot;&gt; &lt;/div&gt; &lt;div&gt; &lt;label&gt;Category&lt;/label&gt; &lt;input id=&quot;hl-cat&quot; value=&quot;devops&quot; maxlength=&quot;24&quot; placeholder=&quot;e.g. devops&quot;&gt; &lt;/div&gt; &lt;/div&gt; &lt;label&gt;Description (house standard: ≤ 60 characters)&lt;/label&gt; &lt;input id=&quot;hl-desc&quot; value=&quot;Acme REST API: auth, pagination, common calls&quot; maxlength=&quot;90&quot;&gt; &lt;div class=&quot;ct&quot; id=&quot;hl-ct&quot;&gt;45 / 60&lt;/div&gt; &lt;label id=&quot;hl-srclabel&quot;&gt;Directory path&lt;/label&gt; &lt;input id=&quot;hl-src&quot; value=&quot;~/projects/acme-sdk&quot;&gt; &lt;label id=&quot;hl-foclabel&quot;&gt;Focus / instruction (optional)&lt;/label&gt; &lt;input id=&quot;hl-focus&quot; value=&quot;focus on auth + pagination&quot;&gt; &lt;div class=&quot;cmdprev cmd&quot; id=&quot;hl-cmdprev&quot;&gt;&lt;/div&gt; &lt;button class=&quot;run&quot; id=&quot;hl-run&quot;&gt;Run /learn ▸&lt;/button&gt; &lt;div class=&quot;out&quot; id=&quot;hl-out&quot;&gt; &lt;div class=&quot;pd&quot;&gt; &lt;div class=&quot;lv&quot;&gt;&lt;b&gt;Level 0&lt;/b&gt;&lt;span&gt;skills_list() · ~3k tokens&lt;/span&gt;&lt;/div&gt; &lt;div class=&quot;lv&quot;&gt;&lt;b&gt;Le