What is hermes-agent-skill-authoring?

A guide for writing SKILL.md files that define reusable workflows for Hermes Agent, either in a shared repository or in a user's local skills folder.

Creating or editing in-repository skills, adding the required front matter and sections, and preparing reusable workflows to ship with Hermes Agent.

It helps skill authors follow the repository's required file format and structure, reducing rejected or incorrectly placed skills.

hermes-agent-skill-authoring — Skill for Claude Code and Codex by aivr

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add aivrar/portable-hermes-agent --skill hermes-agent-skill-authoring

Clone the repo

git clone --depth 1 https://github.com/aivrar/portable-hermes-agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring/github.svg)](https://agentmods.dev/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring)

Your own site

<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/hermes-agent-skill-authoring.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 22 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 3,575 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00022	$0.03575
Opus 5	$0.00011	$0.01788
Sonnet 5	$0.00004	$0.00715
Haiku 4.5	$0.00002	$0.00358

Measured 7d ago against content hash 3a274d5b42fa, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

hermes-agent-skill-authoring scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to hermes-agent-skill-authoring — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/software-development/hermes-agent-skill-authoring/SKILL.md · 213 lines

How it starts

The opening of the file, as written. The whole thing — 213 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Authoring Hermes-Agent Skills (in-repo)

Overview

There are two places a SKILL.md can live:

User-local: ~/.hermes/skills/<maybe-category>/<name>/SKILL.md — personal, not shared. Created via skill_manage(action='create').
In-repo (this skill is about this case): skills/<category>/<name>/SKILL.md or optional-skills/<category>/<name>/SKILL.md inside the hermes-agent repo — committed, shipped with the package. Use write_file + git add. skill_manage(action='create') does NOT target this tree.

In-repo skills must meet the repo's hardline authoring standards (see AGENTS.md, "Skill authoring standards (HARDLINE)" — that section is the source of truth; this skill is the operational walkthrough). Reviewers reject PRs that violate them, so meeting them up front is cheaper than a salvage pass later.

When to Use

User asks you to add a skill "in this branch / repo / commit"
You're committing a reusable workflow that should ship with hermes-agent
You're editing an existing skill under skills/ or optional-skills/ (use patch for small edits, write_file for rewrites; skill_manage still works for patch on in-repo skills, but not for create)
Don't use for: personal skills in ~/.hermes/skills/ (just use skill_manage)

Decide the Tier First: Bundled vs Optional

Bundled (skills/<category>/) — daily-driver behavior, broadly useful across many user types, low footprint. Hard bar: you can say "a user will load this in 5+ sessions per month" with a straight face.
Optional (optional-skills/<category>/) — niche, vertical-specific (blockchain, gaming, finance, one app), recurring-job/task skills, or anything heavy. Installed via hermes skills install official/<category>/<skill>.

When in doubt, optional. Promoting later is easy; demoting is churn. "Would be useful to anyone who ever needs this" is an optional-tier argument, not a bundled one.

Pick the category by what the tool IS, not what it feels like (an AI-agent CLI goes in autonomous-ai-agents/ even if it "feels productivity"). Confirm existing categories with search_files(pattern='*', target='files', path='skills') and don't invent new top-level categories casually.

Read the full file on GitHub · 213 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

7d ago First seen · 213 lines · 22 tokens per session scan A 3a274d5b42fa

Subscribe to this mod's changes

hermes-agent-skill-authoring is a skill published in the GitHub repository aivrar/portable-hermes-agent (217 stars, last pushed 2d ago), licensed MIT. It adds 22 tokens to every session and 3,575 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to hermes-agent-skill-authoring, differing in 0 lines, and is treated as a copy.

Building agents ai ai-agents desktop-app hermes hermes-agent lm-studio

mnemosyne

Persistent cross-session memory via Mnemosyne — store, recall, and consolidate facts, preferences, and context.

mnemosyne-oss/mnemosyne · 22 tokens

hermes-tweet

Use Xquik in Hermes Agent for public X research, monitoring, thread summaries, creator discovery & approved actions. Not affiliated with X Corp. Use when the user requests X data or a named action. Trigger with "search X", "monitor X", "post tweet", or "X trends".

Xquik-dev/hermes-tweet · 65 tokens

hermes-agent-skill-authoring