Skip to content

Add Hermes Tweet signal skill #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kriptoburak wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add Hermes Tweet signal skill #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,15 @@

All notable changes to this repository are documented in this file.

## 2026-07-18

### Added
- Added the `hermes-tweet-signal` skill for read-only X/Twitter research through the Hermes Tweet plugin. The workflow discovers public read routes with `tweet_explore`, uses only returned routes through `tweet_read`, and keeps `tweet_action` disabled for signal briefs. Entry point: `hermes-tweet-signal/SKILL.md`. Requires Hermes Tweet and `XQUIK_API_KEY`.

### Changed
- Updated `README.md` and `CLIENT_SETUP.md` across their skill indexes, setup guidance, install loops, selection guidance, and directory trees.
- Removed stale `academic-slides` references after its skill directory was deleted, preventing the documented bulk-install commands from creating broken links or copying a missing directory.

## 2026-07-11

### Added
Expand Down
36 changes: 16 additions & 20 deletions CLIENT_SETUP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@ Some skills also include helper assets such as:
Current skill directories in this repository:

- `academic-jobs`
- `academic-slides`
- `adversarial-review`
- `bibtex-gen`
- `commit-triage`
- `concept-explainer`
- `dropbox`
- `handdrawn-schematic`
- `hep-rumor-mill`
- `hermes-tweet-signal`
- `journal-club-review`
- `md2pdf-typora`
- `morgen`
Expand Down Expand Up @@ -92,7 +92,7 @@ ln -s "$REPO/vastai" .claude/skills/vastai

```bash
mkdir -p ~/.claude/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
ln -s "$REPO/$skill" "$HOME/.claude/skills/$skill"
done
```
Expand Down Expand Up @@ -140,7 +140,7 @@ ln -s "$REPO/paperbanana" ~/.codex/skills/paperbanana

```bash
mkdir -p ~/.codex/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
ln -s "$REPO/$skill" "$HOME/.codex/skills/$skill"
done
```
Expand Down Expand Up @@ -187,7 +187,7 @@ Use this when you want every skill in this repository available in Forge. This m

```bash
mkdir -p ~/forge/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
rm -rf ~/forge/skills/$skill
cp -R "$REPO/$skill" ~/forge/skills/$skill
done
Expand All @@ -202,14 +202,14 @@ Use this when your local Forge setup allows the skill root itself to be configur
```text
/absolute/path/to/skills/
├── academic-jobs/
├── academic-slides/
├── adversarial-review/
├── bibtex-gen/
├── commit-triage/
├── concept-explainer/
├── dropbox/
├── handdrawn-schematic/
├── hep-rumor-mill/
├── hermes-tweet-signal/
├── journal-club-review/
├── md2pdf-typora/
├── morgen/
Expand Down Expand Up @@ -242,7 +242,7 @@ Because Forge needs real directories (not symlinks), edits made in this reposito

```bash
REPO=/absolute/path/to/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
rm -rf ~/forge/skills/$skill
cp -R "$REPO/$skill" ~/forge/skills/$skill
done
Expand Down Expand Up @@ -280,7 +280,7 @@ Pi reads a `skills` array in `~/.pi/agent/settings.json` (global) or `.pi/settin

```bash
mkdir -p ~/.pi/agent/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
ln -s "$REPO/$skill" "$HOME/.pi/agent/skills/$skill"
done
```
Expand All @@ -291,7 +291,7 @@ This location is shared by every harness that follows the Agent Skills standard,

```bash
mkdir -p ~/.agents/skills
for skill in academic-jobs academic-slides adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
for skill in academic-jobs adversarial-review bibtex-gen commit-triage concept-explainer dropbox handdrawn-schematic hep-rumor-mill hermes-tweet-signal journal-club-review md2pdf-typora morgen overleap overleaf-section-workflow paperbanana proton-mail reference-search research-backup research-log research-portal research-report scienceplot-py vastai wide-slide-illustrator workshop-paper-review xkcd-py zai-web-search; do
ln -s "$REPO/$skill" "$HOME/.agents/skills/$skill"
done
```
Expand Down Expand Up @@ -330,18 +330,6 @@ Requires `uv` on `PATH`; no API keys or credentials. The skill bundles a uv proj
- Validity is judged from each posting's detail page (effective deadline = firm `Appl Deadline`, else `listed until`). `--fast` skips detail pages but misses many valid postings; prefer the default.
- The CLI is polite by design (single session, real User-Agent, inter-request delay, per-run detail-fetch cap). Do not parallelise.

### academic-slides: Node + pnpm (Slidev) + matplotlib/scienceplots/TeX

Two toolchains. Slidev (Node) builds and exports the deck; the scienceplots pipeline (Python) renders the figures. No API keys.

- Install Node.js and `pnpm`. From a deck folder, `pnpm install`, then `pnpm exec playwright install chromium` (Chromium is used only by `slidev export` for the PDF).
- Figures need `matplotlib` + `scienceplots` and a system TeX distribution on `PATH`:
```bash
uv add matplotlib scienceplots numpy
pdflatex --version
```
- If `pnpm install` leaves `esbuild` / `vue-demi` unbuilt, run `pnpm rebuild esbuild vue-demi`; if `slidev export` prompts for a theme, `pnpm add @slidev/theme-default`.

### adversarial-review — no setup required

Spawns persona subagents through the host client's Agent tool and reuses `reference-search` for citation and prior-art checks. No additional CLIs or keys.
Expand Down Expand Up @@ -415,6 +403,14 @@ Requires `uv` on `PATH`; no API keys or credentials. The skill bundles a uv proj
- Optional: set `S2_API_KEY` (same env var `reference-search` uses) to raise the Semantic Scholar rate limit and make citation backfill reliable.
- The CLI paces InspireHEP and OpenAlex requests by design. Do not parallelise.

### hermes-tweet-signal: Hermes Tweet plugin + XQUIK_API_KEY

Requires Hermes Tweet installed in the Hermes runtime and `XQUIK_API_KEY` configured where Hermes executes tools. Leave `HERMES_TWEET_ENABLE_ACTIONS` unset unless a user explicitly approves an action-capable workflow.

- Use `tweet_explore` first to find supported public read routes.
- Use `tweet_read` only for public read-only endpoints returned by discovery.
- Do not call `tweet_action` for monitoring, research, launch reaction, incident, feedback, or community-chatter briefs.

### journal-club-review: uv (+ optional codex for figures)

Requires `uv`. The extractor `scripts/extract_text.py` carries a **PEP 723 inline script metadata** header declaring `pdfplumber`, `httpx`, and `feedparser`, so `uv run` provisions an ephemeral environment on first invocation and reuses the cache after that. No `uv add` step needed.
Expand Down
Loading