hermes-tweet
Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, timeline reading, tweet analysis, and approval-gated tweet actions. Use this skill when installing Hermes Tweet, researching X/Twitter accounts, monitoring launch signals, investigating mentions, auditing giveaways, or preparing guarded tweet actions. Use proactively when a Hermes Agent workflow needs current X/Twitter context. Requires XQUIK_API_KEY for read and action tools.
- License 许可
- MIT
- 最近更新
- 2026-08-19
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- hermes-tweet
- license
- MIT
- metadata
- { "source": "https://github.com/Xquik-dev/hermes-tweet", "version": "0.1.6", "homepage": "https://github.com/Xquik-dev/hermes-tweet#readme" }
- description
- Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, timeline reading, tweet analysis, and approval-gated tweet actions. Use this skill when installing Hermes Tweet, researching X/Twitter accounts, monitoring launch signals, investigating mentions, auditing giveaways, or preparing guarded tweet actions. Use proactively when a Hermes Agent workflow needs current X/Twitter context. Requires XQUIK_API_KEY for read and action tools.
02 资源文件 1
- 参考文档references/workflows.md1.3 KB
03 SKILL.md 正文
Hermes Tweet
Hermes Tweet adds an X/Twitter toolset to Hermes Agent. It is useful for social listening, account research, launch monitoring, support triage, giveaway audits, and controlled publishing workflows where actions stay explicit.
When to Use This Skill
Use this skill when the user wants to:
- Install Hermes Tweet into a Hermes Agent runtime
- Discover available X/Twitter read and action routes
- Read X/Twitter account, tweet, trend, monitor, or search data
- Summarize public signal before drafting responses or campaigns
- Keep account-changing actions gated behind explicit operator intent
Setup
Install the package into the Hermes Python environment, then enable the plugin:
~/.hermes/hermes-agent/venv/bin/python -m pip install hermes-tweet
hermes plugins enable hermes-tweet
Set the API key on the Hermes runtime host:
export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"
Keep HERMES_TWEET_ENABLE_ACTIONS false for read-first sessions. Set it to
true only for sessions that intentionally need posting, replies, DMs, follows,
webhooks, monitors, media changes, or other account-changing routes.
Inputs
Ask for these inputs before selecting routes:
- Objective: research, monitoring, support triage, giveaway audit, or action prep
- Target: account handle, tweet URL, keyword, list, monitor, or trend
- Time window and freshness needs
- Whether any account-changing action is in scope
- Confirmation that the Hermes runtime has
XQUIK_API_KEY
Workflow
- Search the bundled endpoint catalog with
tweet_exploreto find matching routes. - Read X/Twitter data through
tweet_readafter selecting a catalog route. - Execute account-changing routes with
tweet_actiononly after explicit approval. - Keep API keys in environment variables or the Hermes runtime env file.
- Do not paste credentials into prompts, issues, PR comments, or tool inputs.
- Load workflow patterns when the user asks for a campaign, monitor, support, or giveaway workflow instead of a single read.
Tool Model
| Tool | Purpose |
|---|---|
tweet_explore |
Search the bundled endpoint catalog without using the API key. |
tweet_read |
Call catalog-listed read-only endpoints when XQUIK_API_KEY is set. |
tweet_action |
Call action routes only when action gating is enabled. |
Output Format
Return concise operational output:
Summary:
- What was checked and why
Read routes:
- Catalog path, input, and result summary
Action plan:
- Proposed account-changing actions, each awaiting explicit approval
Next check:
- Follow-up route or monitoring cadence when useful
Usage Examples
Research an account before drafting a reply:
Use Hermes Tweet to inspect recent public context for @example before drafting a reply.
Keep actions disabled.
Monitor a launch keyword:
Track X/Twitter mentions for "Example Launch" today.
Summarize themes and notable accounts. Do not post.
Prepare a guarded post:
Draft a launch tweet and list the exact tweet_action call you would use.
Wait for approval before any action route.
Capture structured route notes:
{
"objective": "support-triage",
"route": "/api/v1/x/search",
"action_gate": "disabled",
"approval_required": true
}
Troubleshooting
- If only
tweet_exploreappears, configureXQUIK_API_KEYon the Hermes runtime host and reload or restart the active Hermes session. - If action routes are unavailable, keep reading or set
HERMES_TWEET_ENABLE_ACTIONS=trueonly for an approved action session. - If a route does not match, use
tweet_exploreagain and choose a catalog-listed path instead of guessing endpoints.
Best Practices
- Treat Hermes Tweet as the Hermes-native X/Twitter layer, not a generic API wrapper.
- Keep research and monitoring workflows read-only by default.
- Use Desktop or gateway operator review before account-changing calls.
- Validate the exact catalog path before calling
tweet_readortweet_action. - Restart gateway, cron, or long-running Hermes sessions after env changes.
See Also
The social-publishing plugin complements Hermes Tweet for broad multi-platform publishing. Hermes Tweet is focused on the Hermes Agent X/Twitter toolset and its read-first, approval-gated operating model.
See the official guide at https://github.com/Xquik-dev/hermes-tweet#readme.
04 同仓库更多 Skills
youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
youtube-thumbnail-design
YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image
youtube-short-maker
Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: "youtube short", "make a youtube short", "shorts video", "short-form video". NOT for long-form or landscape video.
xcode-project-setup
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
x402
Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — "just use it" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or "build it in" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.
x-twitter-scraper
Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.