Add Hermes Tweet plugin

.claude-plugin/marketplace.json

@@ -252,6 +252,28 @@
         "reset-countdown"
       ],
       "strict": true
+    },
+    {
+      "name": "hermes-tweet",
+      "source": "./plugins/hermes-tweet",
+      "description": "Hermes Agent plugin guidance for X/Twitter research, social signal analysis, monitored context, and approval-gated account actions.",
+      "version": "0.1.6",
+      "author": {
+        "name": "Xquik",
+        "company": "Xquik"
+      },
+      "category": "content",
+      "keywords": [
+        "hermes-agent",
+        "x",
+        "twitter",
+        "social",
+        "research",
+        "monitoring",
+        "trend-analysis",
+        "approval-gated-actions"
+      ],
+      "strict": true
     }
   ]
 }

README.md

@@ -174,6 +174,23 @@ Deep code investigation and analysis toolkit for understanding complex codebases
 
 ---
 
+#### X/Twitter Research With Hermes Tweet
+
+**Version:** 0.1.6 | **Category:** Content | **Type:** Skills Plugin
+
+Hermes Agent plugin guidance for X/Twitter research, social signal analysis,
+monitored context, and approval-gated account actions through Hermes Tweet.
+
+**Highlights:**
+- **Hermes-native setup** - Install with `hermes plugins install Xquik-dev/hermes-tweet --enable`
+- **Research-first routing** - Use read-only exploration before any account action
+- **Explicit action gate** - Keep posting and engagement behind Hermes Tweet approval controls
+- **Claude Code handoff** - Prepare prompts, workflows, and checks before moving to Hermes Agent
+
+**Perfect for:** Social research, trend monitoring, competitive context, public X/Twitter analysis, and Hermes Agent workflows that need controlled account actions.
+
+---
+
 #### ⚡ Bun Backend Development
 
 **Version:** 1.2.0 | **Category:** Development | **Model:** Sonnet

plugins/hermes-tweet/README.md

@@ -0,0 +1,40 @@
+# Hermes Tweet Plugin
+
+**Version:** 0.1.6
+**License:** MIT
+
+Hermes Tweet helps Hermes Agent workflows research public X/Twitter context,
+monitor social signals, analyze trends, and run account actions only when
+Hermes Tweet action gates are enabled.
+
+## Quick Start
+
+Install Hermes Tweet in Hermes Agent:
+
+```bash
+hermes plugins install Xquik-dev/hermes-tweet --enable
+```
+
+Configure an API key in the Hermes Agent environment:
+
+```bash
+export XQUIK_API_KEY="..."
+```
+
+Enable account actions only when the workflow explicitly needs them:
+
+```bash
+export HERMES_TWEET_ENABLE_ACTIONS=true
+```
+
+## Available Skill
+
+### hermes-tweet
+
+Use this skill when Claude Code is preparing or reviewing a Hermes Agent
+workflow that needs X/Twitter research, monitored context, trend analysis, or
+approval-gated account actions.
+
+The skill keeps the default path read-only, checks that write actions remain
+behind Hermes Tweet action controls, and points users to the native Hermes Agent
+plugin as the runtime surface.

plugins/hermes-tweet/plugin.json

@@ -0,0 +1,28 @@
+{
+  "name": "hermes-tweet",
+  "version": "0.1.6",
+  "description": "Hermes Agent plugin guidance for X/Twitter research, social signal analysis, monitored context, and approval-gated account actions.",
+  "author": {
+    "name": "Xquik",
+    "company": "Xquik"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/Xquik-dev/hermes-tweet",
+  "tags": [
+    "hermes-agent",
+    "x",
+    "twitter",
+    "social-research",
+    "trend-analysis",
+    "monitoring",
+    "approval-gated-actions"
+  ],
+  "category": "content",
+  "skills": [
+    "./skills/hermes-tweet"
+  ],
+  "dependencies": [],
+  "compatibility": {
+    "claudeCode": ">=0.1.0"
+  }
+}

plugins/hermes-tweet/skills/hermes-tweet/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: hermes-tweet
+version: 0.1.6
+description: Use when preparing Hermes Agent workflows that need X/Twitter research, monitored social context, trend analysis, or approval-gated account actions through Hermes Tweet.
+keywords:
+  - hermes agent
+  - hermes tweet
+  - x
+  - twitter
+  - social research
+  - trend analysis
+  - monitoring
+plugin: hermes-tweet
+updated: 2026-06-14
+---
+
+# Hermes Tweet Skill
+
+Use Hermes Tweet when a Hermes Agent workflow needs X/Twitter research or
+controlled account actions.
+
+## Install
+
+Install the native Hermes Agent plugin:
+
+```bash
+hermes plugins install Xquik-dev/hermes-tweet --enable
+```
+
+Set the API key in the Hermes Agent environment:
+
+```bash
+export XQUIK_API_KEY="..."
+```
+
+Only enable actions when the user explicitly asks for account operations:
+
+```bash
+export HERMES_TWEET_ENABLE_ACTIONS=true
+```
+
+## Routing Rules
+
+1. Use read-only exploration for research, trend analysis, profile context,
+   monitored account context, and source gathering.
+2. Treat posting, liking, following, replying, reposting, and profile changes as
+   account actions.
+3. Before any account action, verify that the workflow explicitly asks for it and
+   that Hermes Tweet action gates are enabled.
+4. Keep generated prompts focused on public X/Twitter context and avoid storing
+   credentials in files or conversation notes.
+5. Prefer the native Hermes Agent plugin as the runtime surface. Use this Claude
+   Code skill to prepare, review, or document the workflow.
+
+## Good Fit
+
+- Social signal research before a launch.
+- Trend monitoring and source-backed briefings.
+- Public account or keyword context for planning.
+- Review of Hermes Agent prompts that include X/Twitter tools.
+
+## Not a Fit
+
+- Scraping private or authenticated content outside the user's authorized setup.
+- Running account actions without explicit approval.
+- Replacing the Hermes Agent plugin runtime with ad hoc shell commands.