diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 0faf42f..1882bb4 100644 --- a/.claude-plugin/marketplace.json +++ b/.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" + ] } ] } diff --git a/README.md b/README.md index 541037f..fa39b0f 100644 --- a/README.md +++ b/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. diff --git a/plugins/hermes-tweet/.claude-plugin/plugin.json b/plugins/hermes-tweet/.claude-plugin/plugin.json new file mode 100644 index 0000000..140beea --- /dev/null +++ b/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" + ] +} diff --git a/plugins/hermes-tweet/CHANGELOG.md b/plugins/hermes-tweet/CHANGELOG.md new file mode 100644 index 0000000..8c325c7 --- /dev/null +++ b/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. diff --git a/plugins/hermes-tweet/README.md b/plugins/hermes-tweet/README.md new file mode 100644 index 0000000..1813a9c --- /dev/null +++ b/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: +- PyPI: +- Hermes Agent: diff --git a/plugins/hermes-tweet/skills/hermes-tweet/SKILL.md b/plugins/hermes-tweet/skills/hermes-tweet/SKILL.md new file mode 100644 index 0000000..b7b862b --- /dev/null +++ b/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 +. 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.