Add Hermes Tweet plugin

.claude-plugin/marketplace.json

@@ -1,5 +1,4 @@
 {
-  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "cc-toolkit",
   "owner": {
     "name": "Mateusz Gostański (grixu)",
@@ -169,6 +168,25 @@
         "citations",
         "workflow"
       ]
+    },
+    {
+      "name": "hermes-tweet",
+      "source": "./plugins/hermes-tweet",
+      "description": "Native Hermes Agent X/Twitter plugin guide for Xquik read-first workflows and approval-gated actions.",
+      "version": "0.1.6",
+      "author": {
+        "name": "Xquik",
+        "url": "https://github.com/Xquik-dev"
+      },
+      "category": "productivity",
+      "tags": [
+        "hermes-agent",
+        "xquik",
+        "twitter",
+        "x",
+        "social-media",
+        "automation"
+      ]
     }
   ]
 }

README.md

@@ -63,6 +63,23 @@ Create custom hooks to prevent unwanted behaviors using simple markdown rule fil
 
 See [plugin README](plugins/hookify/README.md) for details.
 
+### hermes-tweet
+
+Native Hermes Agent X/Twitter plugin guide for Xquik read-first workflows and
+approval-gated actions. Use it to install Hermes Tweet, discover
+`tweet_explore`, run read-only X searches and account reads, and keep
+account-changing actions gated by `HERMES_TWEET_ENABLE_ACTIONS=true`.
+
+**Requires:** [Hermes Agent](https://github.com/NousResearch/hermes-agent),
+`XQUIK_API_KEY` for read tools, optional
+`HERMES_TWEET_ENABLE_ACTIONS=true` for actions.
+
+```
+/plugin install hermes-tweet@cc-toolkit
+```
+
+See [plugin README](plugins/hermes-tweet/README.md) for details.
+
 ### namesmith
 
 Business name discovery — generates candidates across 6 naming archetypes, filters them with a challenger sub-agent (5-dimension scoring), then checks domain availability via bundled Instant Domain Search MCP.

plugins/hermes-tweet/.claude-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "hermes-tweet",
+  "version": "0.1.6",
+  "description": "Native Hermes Agent X/Twitter plugin guide for Xquik read-first workflows and approval-gated actions.",
+  "author": {
+    "name": "Xquik",
+    "url": "https://github.com/Xquik-dev"
+  },
+  "repository": "https://github.com/Xquik-dev/hermes-tweet",
+  "keywords": [
+    "hermes-agent",
+    "xquik",
+    "twitter",
+    "x",
+    "social-media",
+    "automation"
+  ]
+}

plugins/hermes-tweet/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to the **hermes-tweet** plugin will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.6] - 2026-06-14
+
+### Added
+
+- Add Hermes Tweet operator guidance for the native Hermes Agent X/Twitter plugin.

plugins/hermes-tweet/README.md

@@ -0,0 +1,48 @@
+# hermes-tweet
+
+Claude Code operator guidance for
+[Hermes Tweet](https://github.com/Xquik-dev/hermes-tweet), the native
+[Hermes Agent](https://github.com/NousResearch/hermes-agent) X/Twitter plugin
+for Xquik workflows.
+
+## What it does
+
+This plugin helps Claude Code users install, configure, and operate Hermes
+Tweet in Hermes Agent without pasting secrets into chat. Hermes Tweet provides
+read-first X/Twitter workflows through `tweet_explore` and `tweet_read`, with
+account-changing actions gated behind `HERMES_TWEET_ENABLE_ACTIONS=true`.
+
+## Installation
+
+Install this Claude Code guide from cc-toolkit:
+
+```text
+/plugin marketplace add grixu/cc-toolkit
+/plugin install hermes-tweet@cc-toolkit
+```
+
+Install the Hermes Agent plugin itself:
+
+```bash
+hermes plugins install Xquik-dev/hermes-tweet --enable
+```
+
+Hermes will prompt for `XQUIK_API_KEY` during an interactive install. For
+non-interactive installs, set the key in the Hermes runtime environment or in
+`~/.hermes/.env` before calling `tweet_read`.
+
+## Usage
+
+Use the bundled `hermes-tweet` skill when a session needs X/Twitter search,
+account reads, trend checks, social listening, launch monitoring, support
+triage, creator research, brand research, giveaway audits, community audits, or
+controlled publishing from Hermes Agent.
+
+Keep actions disabled unless the workflow explicitly requires posting, DMs,
+follows, monitors, webhooks, media changes, extraction jobs, or giveaway draws.
+
+## Links
+
+- Repository: <https://github.com/Xquik-dev/hermes-tweet>
+- PyPI: <https://pypi.org/project/hermes-tweet/>
+- Hermes Agent: <https://github.com/NousResearch/hermes-agent>

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

@@ -0,0 +1,83 @@
+---
+name: hermes-tweet
+description: Use when a Claude Code user wants to install or operate Hermes Tweet, the native Hermes Agent X/Twitter plugin for Xquik workflows.
+---
+
+# Hermes Tweet
+
+Use this skill when the user wants Hermes Agent to search, inspect, summarize,
+or act on X/Twitter through Hermes Tweet.
+
+## Scope
+
+Hermes Tweet is a native Hermes Agent plugin published at
+<https://github.com/Xquik-dev/hermes-tweet>. This Claude Code plugin is an
+operator guide for installing and using that Hermes plugin. It does not replace
+the Hermes Agent runtime package.
+
+## Install
+
+Recommended Hermes install:
+
+```bash
+hermes plugins install Xquik-dev/hermes-tweet --enable
+```
+
+If Hermes discovers the plugin but leaves it disabled, run:
+
+```bash
+hermes plugins enable hermes-tweet
+```
+
+Hermes prompts for `XQUIK_API_KEY` during interactive install. In
+non-interactive installs, configure it in the Hermes runtime environment or in
+`~/.hermes/.env`. Do not ask the user to paste API keys into chat.
+
+## Workflow
+
+1. Use `tweet_explore` to discover the catalog route.
+2. Use `tweet_read` for read-only X/Twitter endpoints.
+3. Use `tweet_action` only after the user approves a write, private read,
+   monitor, webhook, extraction job, giveaway draw, or media operation.
+
+## Decision Rules
+
+- Use `tweet_explore` first for endpoint discovery.
+- Use `tweet_read` only after a read-only endpoint is known.
+- Use `tweet_action` only for non-GET routes, private account state, or
+  account-changing operations.
+- Keep `HERMES_TWEET_ENABLE_ACTIONS=false` unless the session intentionally
+  needs controlled actions.
+- If `tweet_action` is unavailable, explain that actions are intentionally
+  gated by `HERMES_TWEET_ENABLE_ACTIONS=true`.
+- If `XQUIK_API_KEY` is missing, ask the user to configure it in the Hermes
+  runtime environment without sharing the value.
+
+## Good Fits
+
+- Social listening
+- Launch monitoring
+- Support triage
+- Creator or brand research
+- Giveaway and community audits
+- Controlled publishing with explicit approval
+
+## Safety
+
+- Never request, reveal, or place credentials in tool arguments.
+- Never use account connection, re-authentication, API key, billing, credit
+  top-up, or support-ticket endpoints.
+- Do not guess endpoint paths. Use the catalog returned by `tweet_explore`.
+- Summarize any write or private action before calling `tweet_action`.
+
+## Checks
+
+After installing or upgrading Hermes Tweet:
+
+```bash
+hermes plugins list
+hermes tools list
+```
+
+Confirm `hermes-tweet` is enabled, `tweet_explore` is available, and `tweet_read`
+appears only after `XQUIK_API_KEY` is configured.