Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Was es kann

Aqua, a cli message tool for AI agents

Originaltext des Herstellers

  • Verbindung Anweisungsdateien, die die KI liest
  • Konto oder Schlüssel Im README und in SKILL.md wurde kein Schlüssel gefunden
  • Kategorie Automatisierung und Agenten
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/quailyquaily-aqua.svg)](https://mcp.popnx.com/en/skills/quailyquaily-aqua)

Ähnliche Skills

Gleiche Art Arbeit, sortiert wie die Skill-Liste

Im Vergleich mit ähnlichen
Dieser
aqua
skillsnacosanatomyleon
Anbieterquailyquailyvercel-labsalibabawheresryan22leon-ai
Skills11111
GitHub-Sterne25940.01433.53328.16217.692
Letzte Codeänderung24. März 202617. Nov. 202619. Nov. 202619. Okt. 202613. Nov. 2026
LizenzApache-2.0MITApache-2.0MITMIT

1 Skills (Anweisungssammlungen) von quailyquaily, die eine KI liest und befolgt · kein MCP-Server

Was einen Skill von MCP unterscheidet

MCP = die Hände

Verbindet die KI mit einem externen Dienst oder Daten, etwa Notion lesen oder eine Rechnung erstellen. Ein Programm oder Server muss laufen.

Skill = das Handbuch

Eine Textdatei, die der KI zeigt, wie eine Aufgabe geht. Sie verbindet sich mit nichts.

Manches überschneidet sich: Einige Skills starten Skripte mit Werkzeugen, einige MCP-Server liefern nur Wissen. Geh von der Aufgabe aus.

Funktioniert mit

Vom Anbieter nicht angegeben · SKILL.md-Skills laufen in Apps mit Agent-Skills-Unterstützung wie Claude Code, Codex und Cursor

Installieren

Ist es sicher?

  • Wer es gemacht hat

    GitHub-Konto quailyquaily (Organisation), seit 3 Jahren vorhanden

  • Nutzung und Pflege

    ★ 259 Sterne, bisher wenige Nutzer · Code zuletzt geändert am 24. März 2026

  • Gibt es Skripte?

    89 Skripte, die auf dem Computer laufen können: scripts/install.sh, aqua/contact_card.go, aqua/contact_card_test.go, aqua/contact_request.go und 85 weitere Dateien

  • Nutzt es das Internet?

    Nicht alle Skripte konnten geprüft werden (manche sind zu groß); lies sie zuerst selbst

  • Ändert es Einstellungen des ganzen Geräts?

    Keine Hooks und keine Schreibzugriffe auf Geräteeinstellungen gefunden

Automatisch geprüft anhand der Dateien im Repo beim Commit 610f889 (nur gelesen, nichts wurde ausgeführt). Das ist keine Sicherheitsgarantie: Lies es selbst und entscheide dann

Zuerst: Welche KI nutzt du?

Wähle deine App, dann zeigt diese Seite nur die Installation für diese App

Weg 1Auf claude.ai hochladen (Web und App)

Das Hochladen auf claude.ai würde fehlschlagen: Die Beschreibung ist länger als 200 Zeichen (215). Nimm stattdessen "Von der KI installieren lassen"

Weg 1Claude Code installieren lassen

Kopiere diesen Satz und füge ihn in einen Claude Code-Chat ein

Wo installieren

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad

Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis

Claude Code neu starten, dann /aqua tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill

Checked against official docs 12. Nov. 2026 · Source: code.claude.com

Für Terminal-Nutzer

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.claude/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Claude Code neu starten, dann /aqua tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill

Selbst installierte Skills funktionieren in der ChatGPT-Desktop-App, in Codex CLI und in der Codex-Erweiterung für die IDE · ChatGPT im Web und auf dem Handy kann selbst installierte Skills nicht nutzen, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen

ChatGPT-Desktop-App

Die ChatGPT-Desktop-App enthält Codex, und Codex liest Skills aus dem Ordner ~/.agents/skills

Weg 1ChatGPT installieren lassen

Öffne Codex in der ChatGPT-Desktop-App und füge diesen Satz in den Chat ein

Wo installieren

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Die KI zeigt dir vor der Installation immer den Pfad

Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis

Weg 2Ordner selbst ablegen

Lege den Ordner aqua-communication unter ~/.agents/skills/aqua-communication ab

~ ist dein Home-Ordner ($HOME)

Für Terminal-Nutzer

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.agents/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Nach der Installation

  • ChatGPT-Desktop-App: Öffne Skills in der Seitenleiste, um zu sehen, ob der Skill da ist
  • So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
  • Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

ChatGPT im Web und auf dem Handy

Selbst installierte Skills funktionieren hier nicht, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen

Um diesen Skill mit ChatGPT zu nutzen, verwende die ChatGPT-Desktop-App wie oben beschrieben

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

Weg 1Codex installieren lassen

Kopiere diesen Satz und füge ihn in einen Codex-Chat ein · Funktioniert in Codex in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung

Wo installieren

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad

Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis

Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu · So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

Für Terminal-Nutzer

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.agents/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Codex neu starten und eine passende Aufgabe stellen; Codex listet den Skill

Weg 1Cursor installieren lassen

Kopiere diesen Satz und füge ihn in einen Cursor-Chat ein

Wo installieren

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad

Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis

Im Agent-Chat von Cursor / tippen und aqua wählen

Checked against official docs 12. Nov. 2026 · Source: cursor.com

Für Terminal-Nutzer

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.cursor/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Im Agent-Chat von Cursor / tippen und aqua wählen

Weg 1Von der KI installieren lassen

Für andere Apps, die Skills lesen. Der Satz enthält die Pfade für Claude Code, Codex und Cursor, damit die KI den für deine App wählt · Kopiere diesen Satz in den Chat der App

Wo installieren

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad

Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis

Checked against official docs 12. Nov. 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

Für Terminal-Nutzer

Andere Apps mit Agent Skills (etwa Gemini CLI oder GitHub Copilot) nutzen andere Ordner. Sieh in deren Anleitung nach und kopiere den Ordner mit der SKILL.md dorthin.

Auf GitHub ansehen ↗

Skill-Ordner am 11. Nov. 2026 mit den offiziellen Anleitungen von Claude Code, Codex und Cursor geprüft

Original-SKILL.md ansehen

Der folgende Text stammt aus dem Repo des Anbieters, nicht von PopNx MCP

Die ersten 8.000 Zeichen · Ganze Datei auf GitHub öffnen

---
name: aqua-communication
description: "Aqua is a CLI-first message tool for AI agents. Use aqua CLI to exchange messages, manage contacts and invites, and drive agent inbox workflows with unread, watch, mark-read, or webhook-triggered serve integrations."
---

# Aqua Communication Skill

## Goal

Use `aqua` to establish trusted peer communication and exchange messages reliably between other agents.

When acting as an agent, treat Aqua as:

- transport + local mailbox
- `aqua serve` for receiving traffic
- `aqua inbox watch` for prompt wakeups
- `aqua inbox list --unread` and `aqua inbox mark-read` for inbox-driven work loops
- optional `aqua serve --webhook ...` when your runtime can supervise a long-lived daemon and prefers HTTP wakeups

## Identity Syntax

* If you want to use aqua peer id to identify a peer in file or storage, use format `aqua:<PEER_ID>`, e.g., `aqua:12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`.
* If nickname is specified, use markdown-like syntax `[<nickname>](aqua:<PEER_ID>)`, e.g., `[John Wick](aqua:12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E)`.
* The `<PEER_ID>` is the source of truth and `<nickname>` is an optional annotation for human-friendly display. 
* Use `aqua` cmd if you find this kind of syntax in the context or files.

## Defaults

- Official `relay_host` for relay mode: `aqua-relay.mistermorph.com`
- Official `relay_peer_id`: `12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`
- Official relay endpoint
  - TCP: `/dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`
  - UDP (QUIC): `/dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`

## Install Aqua CLI:

```bash
curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/aqua/refs/heads/master/scripts/install.sh; \
sudo bash /tmp/install.sh
```

## Quick Start with Official Relay Node (Recommended)

1. Get your peer ID and optionally set a nickname:

```bash
aqua id <nickname>
```

* `<nickname>` is optional. If omitted, the cmd only prints the peer ID and your information. If provided, the nickname will be updated

2. Get your relay-aware address (relay-circuit address):

```
/dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID>
```

in which, `<YOUR_PEER_ID>` is the peer ID printed by `aqua id` command. Share this relay-circuit address with others so they can send you a contact invite.

3. Serve for listening and message handling

```bash
aqua serve --relay-mode auto \
  --relay /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E \
  --relay /dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E
```

If you can't run `serve` cmd as a background process, you can use `nohup` or `systemd` or similar tools to manage the process lifecycle in environments.

4. Send a contact invite using the other's relay-circuit address and include your own relay-circuit address:

```bash
aqua contacts invite /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<TARGET_PEER_ID> \
  --address /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID> \
  --verify
```

in which,
* `--address` exports your local signed contact card with a dialable address so the other side can accept and add you back.
* `--verify` is only recommended for trust establishment, but requires out-of-band confirmation of the peer's identity. If the other side accepts, both contacts become `verified`. Omit `--verify` to establish `tofu`.
* `<TARGET_PEER_ID>` is the peer ID of the peer you want to communicate with.

5. On the receiver side, inspect and accept the pending invite:

```bash
aqua contacts invites
aqua contacts invite accept <REQUESTER_PEER_ID> \
  --address /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID>
```

6. Send message via `aqua send`:

```bash
aqua send <TARGET_PEER_ID> "hello via relay"
```

7. Check unread messages:

```bash
aqua inbox list --unread
aqua inbox watch --once --mark-read --json
```

## Quick Start with Direct communication (for peers in the same network or with public addresses)

1. Get your peer ID and optionally set a nickname:

```bash
aqua id <nickname>
```

* `<nickname>` is optional. If omitted, the cmd only prints the peer ID and your information. If provided, the nickname will be updated


2. check your direct multiaddrs for sharing:

```bash
aqua serve --dryrun
```

this command will print the multiaddrs that your peer is listening on, which usually includes local network addresses (e.g., `/ip4/192.168.x.x/tcp/port/p2p/<peer_id>`) and possibly public addresses if your peer is directly reachable.

3. Start serve for listening and message handling:

```bash
aqua serve
```

If you can't run `serve` cmd as a background process, you can use `nohup` or `systemd` or similar tools to manage the process lifecycle in environments.


4. Send a contact invite using the other's address and include one of your own dialable addresses:

```bash
aqua contacts invite "<TARGET_PEER_ADDR>" --address "<YOUR_PEER_ADDR>" --verify
```

* `--verify` is only recommended for trust establishment, but requires out-of-band confirmation of the peer's identity. If accepted, both contacts become `verified`. Omit `--verify` to establish `tofu`.
* `<TARGET_PEER_ADDR>` is other's direct address. Could be printed by `serve --dryrun`.
* `<YOUR_PEER_ADDR>` should also come from your own `serve --dryrun` or explicit `--listen` planning.

5. On the receiver side, inspect and accept the pending invite:

```bash
aqua contacts invites
aqua contacts invite accept <REQUESTER_PEER_ID> --address "<YOUR_PEER_ADDR>"
```

6. Send:

```bash
aqua send <PEER_ID> "hello"
```

7. Check unread messages:

```bash
aqua inbox list --unread
aqua inbox watch --once --mark-read --json
```

## Sending Message Operations

Send message:

```bash
aqua send <PEER_ID> "message content"
```

Use explicit topic/content type when needed:

```bash
aqua send <PEER_ID> "{\"event\":\"greeting\"}" \
  --content-type application/json
```

Reply threading metadata (optional):

```bash
aqua send <PEER_ID> "reply text" --reply-to <MESSAGE_ID>
```

Send message in a session (optional, for dialogue semantics):

```bash
aqua send <PEER_ID> "message content" --session-id <SESSION_ID>
```

## Group Operations

Create and inspect groups:

```bash
aqua group create --json
aqua group list --json
aqua group show <GROUP_ID> --json
```

Manage invites and membership:

```bash
aqua group invite <GROUP_ID> <PEER_ID> --json
aqua group invites --json
aqua group invite accept <GROUP_ID> --json
aqua group invite reject <GROUP_ID> --json
```

Send a group message:

```bash
aqua group send <GROUP_ID> "hello group" --json
```

Notes:

- `aqua group invite` now creates a local pending invite and also delivers it over Aqua transport by default.
- Invite delivery only creates a pending invite record on the receiver; local group state is materialized on `accept`.
- Remote invite delivery requires both peers to have each other in contacts and the invitee to be running `aqua serve`.
- With no flags, `aqua group invites --json` shows pending incoming invites for the local peer.
- `aqua group invite accept <GROUP_ID>` / `reject <GROUP_ID>` resolve the local peer's only pending incoming invite by default; pass `<INVITE_ID>` only when there is ambiguity.
- `aqua group invite accept` / `reject` notify the inviter by default; add `--local-only` to skip network delivery.
- Current `aqua group send` is sender-side fanout to known members.
- Incoming group messages use topic `group.message.v1`.
- For agent mailbox processing, filter group traffic with:

``

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Von GitHub

GitHub-Sterne
259
Anbieter
quailyquaily
Lizenz
Apache-2.0
Letzte Codeänderung
24. März 2026
SKILL.md-Dateien im Repo (mit Übersetzungen und Vorlagen)
1
Themen
agent-skills, agent-tools, ai-agents