Hermes Tweet
Unverified●36/40Claude Code◐PartialHas SKILL.md but declares no allowed-tools — Claude Code will ask for permission each time
Cursor·UnknownWe have not crawled the repo tree, so we will not guess
Codex·UnknownWe have not crawled the repo tree, so we will not guess
Gemini CLI·UnknownThe spec defines no detection rule for Gemini
Copilot·UnknownWe have not crawled the repo tree, so we will not guess
npx agentalley add hermes-tweetWho is stuck, and on what
> 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.
The whole source
Frontmatter — 4 properties
| 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 source: https://github.com/Xquik-dev/hermes-tweet homepage: https://github.com/Xquik-dev/hermes-tweet#readme |
| 1 | --- |
| 2 | name: hermes-tweet |
| 3 | description: > |
| 4 | Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, |
| 5 | timeline reading, tweet analysis, and approval-gated private or state-changing |
| 6 | operations. Use this skill when installing Hermes Tweet, researching X/Twitter |
| 7 | accounts, monitoring |
| 8 | launch signals, investigating mentions, auditing giveaways, or preparing gated |
| 9 | X operations. Use proactively when a Hermes Agent workflow needs current |
| 10 | X/Twitter context. Requires XQUIK_API_KEY for read and action tools. |
| 11 | license: MIT |
| 12 | metadata: |
| 13 | version: "0.1.13" |
| 14 | source: https://github.com/Xquik-dev/hermes-tweet |
| 15 | homepage: https://github.com/Xquik-dev/hermes-tweet#readme |
| 16 | ---A5 — No allowed-tools declared — no way to tell what this skill may touch |
| 17 | |
| 18 | # Hermes Tweet |
| 19 | |
| 20 | Hermes Tweet adds an X/Twitter toolset to Hermes Agent. It is useful for social |
| 21 | listening, account research, launch monitoring, support triage, giveaway audits, |
| 22 | and controlled workflows where private or state-changing operations stay |
| 23 | explicit. |
| 24 | |
| 25 | ## When to Use This Skill |
| 26 | |
| 27 | Use this skill when the user wants to: |
| 28 | |
| 29 | - Install Hermes Tweet into a Hermes Agent runtime |
| 30 | - Discover available X/Twitter read and action routes |
| 31 | - Read X/Twitter account, tweet, trend, monitor, or search data |
| 32 | - Summarize public signal before drafting responses or campaigns |
| 33 | - Keep private and state-changing operations gated behind explicit operator intent |
| 34 | |
| 35 | ## Setup |
| 36 | |
| 37 | Install and enable the plugin through Hermes: |
| 38 | |
| 39 | ```bash |
| 40 | hermes plugins install Xquik-dev/hermes-tweet --enable |
| 41 | ``` |
| 42 | |
| 43 | Hermes scans plugins during installation and updates. Review each warning. |
| 44 | A dangerous verdict blocks installation or disables an update. |
| 45 | |
| 46 | Set the API key on the Hermes runtime host: |
| 47 | |
| 48 | ```bash |
| 49 | export XQUIK_API_KEY="<your-key>" |
| 50 | export HERMES_TWEET_ENABLE_ACTIONS="false" |
| 51 | ``` |
| 52 | |
| 53 | Keep `HERMES_TWEET_ENABLE_ACTIONS` false for read-first sessions. Set it to |
| 54 | `true` only for an approved private read, write, monitor, webhook, extraction, |
| 55 | draw, or media operation. |
| 56 | |
| 57 | ## Inputs |
| 58 | |
| 59 | Ask for these inputs before selecting routes: |
| 60 | |
| 61 | - Objective: research, monitoring, support triage, giveaway audit, or action prep |
| 62 | - Target: account handle, tweet URL, keyword, list, monitor, or trend |
| 63 | - Time window and freshness needs |
| 64 | - Whether any private or state-changing operation is in scope |
| 65 | - Confirmation that the Hermes runtime has `XQUIK_API_KEY` |
| 66 | |
| 67 | ## Workflow |
| 68 | |
| 69 | 1. Search the bundled endpoint catalog with `tweet_explore` to find matching routes. |
| 70 | 2. Read public X/Twitter data through `tweet_read` after selecting a catalog route. |
| 71 | 3. Use `tweet_action` for private or state-changing routes only after explicit approval. |
| 72 | 4. Keep API keys in environment variables or the Hermes runtime env file. |
| 73 | 5. Do not paste credentials into prompts, issues, PR comments, or tool inputs. |
| 74 | 6. Load [workflow patterns](references/workflows.md) when the user asks for a |
| 75 | campaign, monitor, support, or giveaway workflow instead of a single read. |
| 76 | |
| 77 | ## Tool Model |
| 78 | |
| 79 | | Tool | Purpose | |
| 80 | | --- | --- | |
| 81 | | `tweet_explore` | Search the bundled endpoint catalog without using the API key. | |
| 82 | | `tweet_read` | Call catalog-listed public read-only endpoints when `XQUIK_API_KEY` is set. | |
| 83 | | `tweet_action` | Call private reads, writes, monitors, webhooks, extractions, draws, and media operations only when action gating is enabled. | |
| 84 | |
| 85 | ## Output Format |
| 86 | |
| 87 | Return concise operational output: |
| 88 | |
| 89 | ```text |
| 90 | Summary: |
| 91 | - What was checked and why |
| 92 | |
| 93 | Read routes: |
| 94 | - Catalog path, input, and result summary |
| 95 | |
| 96 | Action plan: |
| 97 | - Proposed private or state-changing operations, each awaiting explicit approval |
| 98 | |
| 99 | Next check: |
| 100 | - Follow-up route or monitoring cadence when useful |
| 101 | ``` |
| 102 | |
| 103 | ## Usage Examples |
| 104 | |
| 105 | Research an account before drafting a reply: |
| 106 | |
| 107 | ```text |
| 108 | Use Hermes Tweet to inspect recent public context for @example before drafting a reply. |
| 109 | Keep actions disabled. |
| 110 | ``` |
| 111 | |
| 112 | Monitor a launch keyword: |
| 113 | |
| 114 | ```text |
| 115 | Track X/Twitter mentions for "Example Launch" today. |
| 116 | Summarize themes and notable accounts. Do not post. |
| 117 | ``` |
| 118 | |
| 119 | Prepare a guarded post: |
| 120 | |
| 121 | ```text |
| 122 | Draft a launch tweet and list the exact tweet_action call you would use. |
| 123 | Wait for approval before any action route. |
| 124 | ``` |
| 125 | |
| 126 | Capture structured route notes: |
| 127 | |
| 128 | ```json |
| 129 | { |
| 130 | "objective": "support-triage", |
| 131 | "route": "/api/v1/x/search", |
| 132 | "action_gate": "disabled", |
| 133 | "approval_required": true |
| 134 | } |
| 135 | ``` |
| 136 | |
| 137 | ## Troubleshooting |
| 138 | |
| 139 | - If only `tweet_explore` appears, configure `XQUIK_API_KEY` on the Hermes runtime |
| 140 | host and reload or restart the active Hermes session. |
| 141 | - If action routes are unavailable, keep public reads separate. Set |
| 142 | `HERMES_TWEET_ENABLE_ACTIONS=true` only for an approved private or |
| 143 | state-changing operation. |
| 144 | - If a route does not match, use `tweet_explore` again and choose a catalog-listed |
| 145 | path instead of guessing endpoints. |
| 146 | |
| 147 | ## Best Practices |
| 148 | |
| 149 | - Treat Hermes Tweet as the Hermes-native X/Twitter layer, not a generic API wrapper. |
| 150 | - Keep research read-only by default. Require approval before creating or |
| 151 | changing monitors. |
| 152 | - Use Desktop or gateway operator review before private or state-changing calls. |
| 153 | - Validate the exact catalog path before calling `tweet_read` or `tweet_action`. |
| 154 | - Restart gateway, cron, or long-running Hermes sessions after env changes. |
| 155 | |
| 156 | ## See Also |
| 157 | |
| 158 | The social-publishing plugin complements Hermes Tweet for broad multi-platform |
| 159 | publishing. Hermes Tweet is focused on the Hermes Agent X/Twitter toolset and its |
| 160 | read-first, approval-gated operating model. |
| 161 | |
| 162 | See [the endpoint and approval contract](references/endpoint-contract.md) when a |
| 163 | route boundary is unclear. See the official guide at |
| 164 | https://github.com/Xquik-dev/hermes-tweet#readme. |
| 165 |
Reviews
Installed this one?Write the first review and take the Trailblazer badge.
Alternatives
Research Review via External Reviewer Backend (ultra reasoning)Get a deep critical review of research from an external reviewer backend (Codex or manual). Use when user says "review my research", "help me review", "get external review", or wants critical feedback on research ideas, papers, or experimental results.●····●38/40Training CheckPeriodically check WandB metrics during training to catch problems early (NaN, loss divergence, idle GPUs). Avoids wasting GPU hours on broken runs. Use when training is running and you want automated health checks.●····●37/40Changelog AutomationAutomate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.◐····●36/40Social Publishing> Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API. Use when the user wants to publish, schedule, or manage social media content programmatically. Requires SOCIALCLAW_API_KEY.◐····●34/40