docs: add Hermes Tweet plugin context

[kriptoburak]

Summary

• Clarify that Minions tasks run normal Hermes sessions with installed plugins and skills available.
• Add Hermes Tweet as the concrete X/Twitter context example for research or content tasks.

Validation

• git diff --check
• added-line safety scan
• python3 tests/test_hermes_worker_resolve.py

[greptile-apps]

Greptile Summary

This PR adds a single FAQ entry to README.md clarifying that Minions task sessions are normal Hermes sessions, meaning installed plugins and skills remain accessible to the agent, with hermes-tweet cited as a concrete example.

• The new FAQ correctly describes Minions' session model (backed by AGENTS.md), but introduces "plugins" as a term that has no definition or documentation in AGENTS.md — only "skills" with the external_dirs mechanism are documented internally.
• The example link points to github.com/Xquik-dev/hermes-tweet, an unofficial third-party community repo; no official Hermes plugin index or NousResearch-endorsed resource is referenced instead.

Confidence Score: 3/5

Documentation-only change, no runtime code altered, but the FAQ introduces an external link to an unvetted community repository and uses terminology that conflicts with the internal architecture docs.

The core claim in the FAQ is accurate — Minions tasks are genuine Hermes sessions and do inherit the local profile. However, the word 'plugins' has no definition anywhere in AGENTS.md (only 'skills' with a specific install mechanism), and the only named example is a link to a third-party GitHub repo that is not officially affiliated with NousResearch. If the PR author is associated with that repo, this is self-promotional content in the project's primary README. Both issues should be resolved before this lands.

README.md — the new FAQ entry at lines 69–73 needs the external link and 'plugins' terminology reviewed before merging.

Important Files Changed

Filename	Overview
README.md	Adds a FAQ entry about plugin/skill availability in Minions task sessions; introduces an unvetted third-party GitHub link and undocumented 'plugins' terminology that does not align with AGENTS.md.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User creates Minions task] --> B[Minions spawns Hermes root session\ntasks.id = Hermes session ID]
    B --> C{Hermes session inherits\nlocal Hermes profile}
    C --> D[Skills via external_dirs\nMINIONS_HOME/skills/]
    C --> E[Plugins configured in\n~/.hermes/config.yaml]
    D --> F[Available to AIAgent\nduring run_conversation]
    E --> F
    F --> G[e.g. hermes-tweet\ngithub.com/Xquik-dev/hermes-tweet]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[User creates Minions task] --> B[Minions spawns Hermes root session\ntasks.id = Hermes session ID]
    B --> C{Hermes session inherits\nlocal Hermes profile}
    C --> D[Skills via external_dirs\nMINIONS_HOME/skills/]
    C --> E[Plugins configured in\n~/.hermes/config.yaml]
    D --> F[Available to AIAgent\nduring run_conversation]
    E --> F
    F --> G[e.g. hermes-tweet\ngithub.com/Xquik-dev/hermes-tweet]

Loading

_{Reviews (1): Last reviewed commit: "docs: add Hermes Tweet plugin context" | Re-trigger Greptile}

[greptile-apps]

Third-party promotional link without official vetting

The link points to github.com/Xquik-dev/hermes-tweet, an unofficial community repository, embedded in the project's primary README as the only concrete example of the plugin/skills feature. This is the first time an external, non-NousResearch repository is cited in official documentation. If the PR author is affiliated with that repo this reads as self-promotion; if they aren't, it cites an untested third-party project without any endorsement rationale. Either way, the official docs now carry a hard dependency on an external repo that can go private, get deleted, or be abandoned — leaving a dead link and no context. Consider linking to the official Hermes documentation on extending Hermes (e.g., https://hermes-agent.nousresearch.com/docs/) rather than a specific community plugin.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

[greptile-apps]

"Plugins" terminology is undocumented in AGENTS.md

AGENTS.md exclusively uses the term "skills" when describing how Minions extends agent capabilities (registered via external_dirs in ~/.hermes/config.yaml). The word "plugins" appears nowhere in the internal architecture docs. Adding it here without clarifying whether it refers to the same mechanism, a separate Hermes plugin system, or both may mislead users who consult AGENTS.md for implementation detail. If "plugins" is simply a user-facing synonym for Hermes skills, the FAQ should say so; if it's a distinct Hermes concept with a different installation path, it should be called out explicitly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!