skills.rest
wshobson
wshobsonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hermes-tweet

Install and operate the Hermes Tweet plugin for X/Twitter research and approval-gated operations.

39.3k|4.2k|Updated Jul 24, 2025
Search Tags:#Twitter#X#social-listening#approval-gating#tweet-analysis#Monitoring#Hermes-Agent
One-click install
npx skills add https://github.com/wshobson/agents --skill hermes-tweet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-tweet
Source: https://github.com/wshobson/agents/tree/main/plugins/hermes-tweet/skills/hermes-tweet
Command: npx skills add https://github.com/wshobson/agents --skill hermes-tweet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Working with X/Twitter data inside a Hermes Agent runtime requires knowing which endpoints exist, which are read-only, and which operations change state. This Skill provides a structured, read-first operating model for X/Twitter research, monitoring, and gated actions so private or state-changing operations never happen without explicit approval.

Core Features & Use Cases

  • Endpoint Discovery: Search a bundled endpoint catalog with tweet_explore to find matching X/Twitter routes without consuming API quota.
  • Read-Only Research: Read accounts, tweets, trends, monitors, and search results through tweet_read once XQUIK_API_KEY is configured.
  • Approval-Gated Actions: Execute writes, monitors, webhooks, extractions, giveaway draws, and media operations through tweet_action only after explicit operator approval.
  • Use Case: Before replying to a mention, inspect the account's recent public context with read-only routes, summarize themes, then draft a reply and list the exact tweet_action call while waiting for approval.

Quick Start

Install the plugin with hermes plugins install Xquik-dev/hermes-tweet --enable, set XQUIK_API_KEY, then ask the agent to research an X/Twitter account using read-only routes.

Frequently Asked Questions about hermes-tweet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the Hermes Tweet plugin for X/Twitter research?▼

Run hermes plugins install Xquik-dev/hermes-tweet --enable in your Hermes Agent runtime, then set the XQUIK_API_KEY environment variable on the host. Hermes scans the plugin during installation and blocks it if a dangerous verdict appears.

How do I read X/Twitter account and tweet data with Hermes Agent?▼

First use tweet_explore to search the bundled endpoint catalog for a matching route, then call tweet_read with that catalog-listed path. tweet_read only works when XQUIK_API_KEY is configured and only accepts public read-only routes.

Why is only tweet_explore available in my Hermes session?▼

tweet_read and tweet_action do not appear until XQUIK_API_KEY is set on the Hermes runtime host. After setting the key, reload or restart the active Hermes session, or run hermes gateway restart for gateway sessions.

Can Hermes Tweet post tweets or create monitors automatically?▼

No. Private reads, writes, monitors, webhooks, extractions, draws, and media operations require HERMES_TWEET_ENABLE_ACTIONS=true plus explicit user approval for each exact operation. Approval for one operation does not authorize retries or related operations.

What is the difference between tweet_read and tweet_action?▼

tweet_read calls catalog-listed public read-only endpoints and needs only the API key. tweet_action handles all private or state-changing operations and additionally requires the action gate to be enabled and per-operation user approval.

Related Skills

Explore More Marketing & Sales Skills→
shuff57shuff57

hermes-configuration

Configure Hermes Agent model and provider settings with dynamic switching.

Community
Advanced
brudexbrudex

social-media-manager

Coordinate social media planning and publishing workflows across campaigns.

Community
Advanced
RambleRainbowRambleRainbow

x-api

Automate X API posting, reading, searching, and analytics with OAuth.

Community
Intermediate
azmiariffarisazmiariffaris

xitter

Interact with the X/Twitter API via the x-cli terminal tool.

Community
Intermediate