Skip to content

wshobson/agents / plugins/hermes-tweet/skills/hermes-tweet

hermes-tweet

Verified

Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, timeline reading, tweet analysis, and approval-gated private or state-changing operations. Use this skill when installing Hermes Tweet, researching X/Twitter accounts, monitoring launch signals, investigating mentions, auditing giveaways, or preparing gated X operations. Use proactively when a Hermes Agent workflow needs current X/Twitter context. Requires XQUIK_API_KEY for read and action tools.

FileKindSize
SKILL.mdskill md5.4 KB
references/endpoint-contract.mdmarkdown1.6 KB
references/workflows.mdmarkdown1.4 KB

references/endpoint-contract.md

View on GitHub
# Endpoint and Approval Contract

Use this reference when a selected Xquik route or approval boundary is unclear.
The rules apply to CLI, Desktop, dashboard, gateway, scheduled, and delegated
Hermes Agent sessions.

## Tool Matrix

| Tool | API key | Network | Action gate | User approval |
| --- | ---: | ---: | ---: | ---: |
| `tweet_explore` | No | No | No | No |
| `tweet_read` | Yes | Yes | No | No for public read-only routes |
| `tweet_action` | Yes | Yes | Yes | Yes for the exact operation |

`tweet_explore` reads the bundled catalog. `tweet_read` accepts only
catalog-listed public read-only routes. `tweet_action` handles writes, private
reads, monitors, webhooks, extraction jobs, giveaway draws, and media
operations.

## Approval Checklist

Before calling `tweet_action`, state and confirm:

1. The catalog-listed endpoint and method.
2. The target account or workflow.
3. The complete payload without credentials.
4. The expected side effects and reason.
5. The user's explicit approval for this operation.

Approval for one operation does not authorize retries, related operations, or
future scheduled runs. Stop after policy, authentication, validation, or
account-state failures.

## Runtime Checks

```bash
hermes plugins list
hermes tools list
```

Confirm that `tweet_explore` remains available without `XQUIK_API_KEY`,
`tweet_read` appears only with the key, and `tweet_action` remains unavailable
unless `HERMES_TWEET_ENABLE_ACTIONS=true` is intentionally configured.

After environment changes, reload an active CLI session. For gateway use, run
`hermes gateway restart`, then start a new gateway session.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall