Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/community/hermes-tweet/hermes_tweet/skills/hermes-tweet

hermes-tweet

Verified

Use Xquik in Hermes Agent for public X research, monitoring, thread summaries, creator discovery & approved actions. Not affiliated with X Corp. Use when the user requests X data or a named action. Trigger with "search X", "monitor X", "post tweet", or "X trends".

FileKindSize
SKILL.mdskill md10.0 KB
references/endpoint-contract.mdmarkdown2.6 KB
skill-card.mdmarkdown3.6 KB

references/endpoint-contract.md

View on GitHub
# Endpoint and approval contract

Use this reference when the 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 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.

## Hermes Agent interfaces

Hermes Tweet uses the same plugin entry point across Desktop, TUI, CLI,
dashboard, and gateway sessions. Install and configure the plugin on the Hermes
runtime host where tools execute. Remote Desktop profiles do not move secrets or
plugin state from the gateway host.

Use active CLI or gateway sessions for `/xstatus` and `/xtrends`. Keep
`HERMES_TWEET_ENABLE_ACTIONS=false` unless the session intentionally permits an
approved account-changing operation.

## 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 session.

## Version history

- **0.1.8.** Clarify the separate Xquik MCP integration and package discovery scope.
- **0.1.7.** Align prepaid read and direct MPP metadata with the current API.
- **Unreleased.** Add marketplace metadata, required sections, and reference docs.
- **Unreleased.** Add capability declarations, risk controls, and release gates.
- **0.1.6.** Refresh catalog wording from the current Xquik OpenAPI.
- **0.1.5.** Add registry metadata and Hermes runtime guidance.
- **0.1.4.** Add public registry frontmatter for Skill discovery.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall