Hermes Tweet

What it does

When your agent uses it

• Installing Hermes Tweet
• Researching X/Twitter accounts
• Monitoring launch signals
• Investigating mentions

Example prompts

• “/hermes-tweet”

Requirements

• A credential in XQUIK_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Search the bundled endpoint catalog with tweet_explore to find matching routes.
2. 2Read public X/Twitter data through tweet_read after selecting a catalog route.
3. 3Use tweet_action for private or state-changing routes only after explicit approval.
4. 4Keep API keys in environment variables or the Hermes runtime env file.
5. 5Do not paste credentials into prompts, issues, PR comments, or tool inputs.
6. 6Load workflow patterns when the user asks for a

What it can do on your machine

Read from SKILL.md and the folder at commit 46891e7. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and json).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • github.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • XQUIK_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hermes Tweet loads about 1.4k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 123 tokens; SKILL.md has 514 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~123

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wshobson/agents at commit 46891e7, republished under its MIT licence (© wshobson). 514 words, ~1,377 tokens.

name

hermes-tweet

description

Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, timeline reading, tweet analysis, and approval-gated private or state-changing operations. Use this skill when installing Hermes Tweet, researching X/Twitter accounts, monitoring launch signals, investigating mentions, auditing giveaways, or preparing gated X operations. Use proactively when a Hermes Agent workflow needs current X/Twitter context. Requires XQUIK_API_KEY for read and action tools.

license

MIT

metadata.version

0.1.13

metadata.source

https://github.com/Xquik-dev/hermes-tweet

metadata.homepage

https://github.com/Xquik-dev/hermes-tweet#readme

hermes plugins install Xquik-dev/hermes-tweet --enable

export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Summary:
- What was checked and why

Read routes:
- Catalog path, input, and result summary

Action plan:
- Proposed private or state-changing operations, each awaiting explicit approval

Next check:
- Follow-up route or monitoring cadence when useful

Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.

Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.

Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

© wshobson, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/hermes-tweet/skills/hermes-tweet of wshobson/agents.

• SKILL.md
• references/endpoint-contract.md
• references/workflows.md

Open the folder on GitHubat commit 46891e7