NousResearch/hermes-collective-wisdom

NousResearch/hermes-collective-wisdom

Description: Plugin enabling the collective wisdom features

Language: Python

License: MIT

Stars: 0

Forks: 0

Open issues: 10

Created: 2026-09-11T21:14:27Z

Pushed: 2026-10-23T00:22:02Z

Default branch: main

Fork: no

Archived: no

README:

Collective Wisdom for Hermes Agent

> Official Hermes Agent plugin from Nous Research.

Collective Wisdom lets a team share the Hermes skills that work for them. An author shares a local skill after one exact review, and it appears in the team's skill library in Nous Portal. Teammates find it in the Portal or in Hermes and install that exact version. Hermes can rank your own most-used skills and, when you ask, suggest which ones are worth sharing. Sharing itself always stays your decision.

You stay in control at every step:

• Installing the plugin uploads nothing and enrolls nothing.
• Every share is one review of the exact files that will be published.
• Every install is one exact version, and declared setup commands never run without a separate approval.
• Nothing happens in the background: Collective Wisdom acts only when you run one of its commands.

Requirements

• Hermes Agent 0.21.5 or newer.
• A Nous account in a team that has Collective Wisdom enabled. Personal accounts do not have access.
• Linux or macOS for installing skills. Windows is not supported for managed skill installation.

Install

hermes plugins install NousResearch/hermes-collective-wisdom --enable

Install clones the repository's default branch, prepares the plugin's Python dependencies, enables the plugin and then shows the next step, hermes wisdom setup. Installing or enabling the plugin never runs setup. Plugins are installed per profile: add -p after hermes for another profile. Start a new Hermes session afterwards. If you use the messaging gateway, also run hermes gateway restart.

In Hermes Desktop, enable Collective Wisdom in Capabilities → Plugins (also available through the command palette).

Update

hermes plugins update collective-wisdom

Update pulls the latest commit of the branch you installed and asks you to approve any new capabilities the plugin declares. Then start a new Hermes session, and run hermes gateway restart if you use the messaging gateway.

Sign in and enable

Collective Wisdom uses the Nous sign-in Hermes already has. Check it, and sign in if needed:

hermes auth status nous
hermes auth add nous # only if you are not signed in

Then enable Collective Wisdom for this profile:

hermes wisdom setup

Setup shows what data leaves your machine (see [Privacy and data use](#privacy-and-data-use)) and registers the profile with your team after you accept. Changing account or team means running setup again. Until a profile is set up, every other hermes wisdom and /wisdom command (except status, help, top and share-suggest, which work without setup) replies with this step and changes nothing. In Telegram and Slack the reply names the terminal command: setup is accepted only in the terminal.

Verify

hermes wisdom status # "active" when the profile is enrolled
hermes wisdom browse # your team's shared skills; empty until someone shares

What you can do

Find what is worth sharing

hermes wisdom top ranks your own local skills by how often Hermes used them, then by edits, then by last use. Skills that came with Hermes, from the Skills Hub or from your team are left out, and skills you already shared are labelled Shared.

/wisdom share-suggest starts a normal Hermes turn in the current conversation with up to 30 of your top skills. Hermes answers with up to 10 ranked suggestions, each with a short reason and the exact command to share it. It never shares anything itself.

Share a skill

hermes wisdom share

Share builds the exact package and shows one review: the team, who will see it, the version, the description, every file, and the local security checks. You can open a file, edit the description or the files, then choose Share or cancel. In a private Telegram chat or Slack DM, /wisdom share opens the same review as a card with Share, Cancel and View details, and only Share publishes.

The shared name and description come from the skill's SKILL.md frontmatter. Shared copy needs a name of up to 100 characters and a description of up to 320. If either one is missing or too long, Hermes sends the SKILL.md to your configured model, which proposes only that field, and the review says "Description written by Hermes from your SKILL.md". View details shows your original, you can edit the proposal in hermes wisdom share, and Share publishes exactly what the review shows. When Hermes cannot propose copy (no model, the setting below is off, the skill may contain a secret, or the model fails), the review names the exact problem, for example "Description is 839 characters; the limit is 320.", and nothing is uploaded.

The shared requirements come only from what the skill declares (platforms, architectures and metadata.hermes in SKILL.md), never from the machine that shares it.

The result is one of: shared (with the version, a Portal link and the install command for teammates), already shared, blocked by a security check, name already owned by another author, not entitled, invalid package, or uncertain. An uncertain result names a status command to check; do not share again until you have checked it.

Publish a new version

Edit the skill and run the same share command. The review shows the version change, for example v1 to v2. Only the author of a skill can publish new versions under its name.

Discover skills

In the Portal, the team library lists every shared skill with search by name, author and keywords, and highlights skills published or updated since you last looked. A skill's page shows its description, security checks, version history, requirements and the exact install commands.

In Hermes:

hermes wisdom browse [query] # search the team library
hermes wisdom show # one skill
hermes wisdom versions # its published versions

The same reads work as /wisdom browse, /wisdom show and /wisdom versions in any Hermes chat.

Install a skill

hermes wisdom install # the latest version
hermes wisdom install @v2 # an exact version
hermes wisdom install --plan...