diff --git a/index.json b/index.json index f58cc4a..a9abfb5 100644 --- a/index.json +++ b/index.json @@ -11,6 +11,18 @@ "download_url": "https://raw.githubusercontent.com/tinyhumansai/skill-registry/main/skills/git-summary/SKILL.md", "stars": 0, "updated_at": "2026-06-07T00:00:00Z" + }, + { + "id": "hermes-tweet", + "name": "Hermes Tweet", + "description": "Use Hermes Tweet from Hermes Agent for X/Twitter search, social listening, publishing, monitors, webhooks, media, draws, and trend reads through Xquik.", + "format": "agentskills", + "author": "Xquik", + "version": "0.1.6", + "tags": ["hermes-agent", "xquik", "twitter", "x", "social-media", "automation"], + "download_url": "https://raw.githubusercontent.com/tinyhumansai/skill-registry/main/skills/hermes-tweet/SKILL.md", + "stars": 0, + "updated_at": "2026-06-21T00:00:00Z" } ] } diff --git a/skills/hermes-tweet/SKILL.md b/skills/hermes-tweet/SKILL.md new file mode 100644 index 0000000..100d76f --- /dev/null +++ b/skills/hermes-tweet/SKILL.md @@ -0,0 +1,75 @@ +--- +name: hermes-tweet +description: "Use Hermes Tweet from Hermes Agent for X/Twitter search, social listening, publishing, monitors, webhooks, media, draws, and trend reads through Xquik." +metadata: + version: "0.1.6" + author: "Xquik" + tags: ["hermes-agent", "xquik", "twitter", "x", "social-media", "automation"] +license: MIT +--- + +# Hermes Tweet + +Use Hermes Tweet when a Hermes Agent workflow needs X/Twitter context or controlled X account actions. + +Hermes Tweet is a native Hermes Agent plugin published as the `hermes-tweet` Python package. It exposes a read-first Xquik toolset with `tweet_explore`, `tweet_read`, and approval-gated `tweet_action`. + +## Setup + +Install and enable the plugin in the Hermes runtime: + +```bash +hermes plugins install Xquik-dev/hermes-tweet --enable +``` + +If Hermes already installed the package without enabling it, run: + +```bash +hermes plugins enable hermes-tweet +``` + +Set `XQUIK_API_KEY` in the Hermes runtime environment or `~/.hermes/.env`. Do not paste API keys into chat, prompts, logs, issue bodies, or tool inputs. + +Keep account-changing actions disabled unless the session needs them: + +```bash +export HERMES_TWEET_ENABLE_ACTIONS=false +``` + +Set `HERMES_TWEET_ENABLE_ACTIONS=true` only for sessions that need approved +account actions. + +## Workflow + +1. Use `tweet_explore` to find a catalog-listed `/api/v1/...` endpoint. This does not need network credentials. +2. Use `tweet_read` for public read-only endpoints after the route is known. This requires `XQUIK_API_KEY`. +3. Use `tweet_action` only for writes, private reads, monitors, webhooks, extraction jobs, media, or giveaway draws after the user approves the exact action. This requires `XQUIK_API_KEY` and `HERMES_TWEET_ENABLE_ACTIONS=true`. + +## When to Use + +- Social listening and launch monitoring. +- Creator, brand, and community research. +- Support triage from public mentions or profiles. +- Giveaway and follower evidence checks. +- Drafting or publishing X posts through an explicit approval step. +- Hermes Desktop, TUI, CLI, remote gateway, or cron sessions that need the same enabled `hermes-tweet` toolset. + +## Safety Rules + +- Never ask for or reveal API keys, passwords, cookies, signing keys, or TOTP secrets. +- Never pass credentials in tool arguments. +- Do not guess endpoint paths. Use `tweet_explore`. +- Do not use dashboard-admin, billing, credit top-up, API-key, account re-authentication, or support-ticket endpoints. +- Keep `tweet_action` disabled for unattended or read-only workflows. +- For remote gateway profiles, install and configure Hermes Tweet on the remote Hermes host where plugin tools execute. + +## Checks + +After setup, verify: + +```bash +hermes plugins list +hermes tools list +``` + +Confirm `hermes-tweet` is enabled, `tweet_explore` appears without `XQUIK_API_KEY`, `tweet_read` appears after the key is configured, and `tweet_action` appears only when actions are enabled.