Qué hace
Aqua, a cli message tool for AI agents
Texto original del autor
- Conexión Archivos de instrucciones que lee la IA
- Cuenta o clave No se encontró ninguna clave en el README ni en SKILL.md
- Categoría Automatización y agentes
Para autores: añade una insignia a tu README
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/skills/quailyquaily-aqua)Skills parecidas
Mismo tipo de trabajo, ordenadas como la lista de Skills
1 skills (conjuntos de instrucciones) de quailyquaily que la IA lee y sigue · no es un MCP server
En qué se diferencia un Skill de MCP
MCP = las manos
Conecta la IA a un servicio o dato externo, como leer Notion o crear una factura. Necesita un programa o servidor en marcha.
Skill = el manual
Un archivo de texto que enseña a la IA cómo hacer una tarea. No se conecta a nada.
A veces se parecen: algunas Skills ejecutan scripts que llaman herramientas y algunos MCP solo envían conocimiento. Empieza por la tarea que quieres hacer.
Funciona con
El autor no lo indica · los skills con SKILL.md funcionan en apps compatibles con Agent Skills, como Claude Code, Codex y Cursor
Instalar
¿Es seguro?
- Quién lo hizo
Cuenta de GitHub quailyquaily (organización), creada hace 3 años
- Uso y mantenimiento
★ 259 estrellas, todavía pocos usuarios · código modificado por última vez el 24 mar 2026
- ¿Tiene scripts?
89 scripts que se pueden ejecutar en el ordenador: scripts/install.sh, aqua/contact_card.go, aqua/contact_card_test.go, aqua/contact_request.go y 85 archivos más
- ¿Usa internet?
No se pudieron revisar todos los scripts (algunos son demasiado grandes); léelos antes
- ¿Cambia ajustes de todo el equipo?
No se encontraron hooks ni escrituras en los ajustes del equipo
Revisado automáticamente a partir de los archivos del repositorio en el commit 610f889 (solo lectura, no se ejecutó nada). No es una garantía de seguridad: léelo y decide por ti mismo
Primero: ¿qué IA usas?
Elige tu app y esta página mostrará solo cómo instalarlo en ella
Opción 1Subir a claude.ai (web y app)
La subida a claude.ai fallaría: la descripción tiene más de 200 caracteres (215). Usa mejor "Que la IA lo instale por ti"
Opción 1Deja que Claude Code lo instale
Copia esta frase y pégala en un chat de Claude Code
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Vuelve a abrir Claude Code y escribe /aqua, o pide una tarea relacionada y Claude lo usará
Checked against official docs 12 nov 2026 · Source: code.claude.com
Para quien usa Terminal
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Copia la carpeta del skill a ~/.claude/skills
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Vuelve a abrir Claude Code y escribe /aqua, o pide una tarea relacionada y Claude lo usará
App de escritorio de ChatGPT
La app de escritorio de ChatGPT incluye Codex, y Codex lee las skills de la carpeta ~/.agents/skills
Opción 1Deja que ChatGPT lo instale
Abre Codex en la app de escritorio de ChatGPT y pega esta frase en el chat
La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Opción 2Coloca la carpeta tú mismo
Coloca la carpeta aqua-communication en ~/.agents/skills/aqua-communication
~ es tu carpeta de inicio ($HOME)
Para quien usa Terminal
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Copia la carpeta del skill a ~/.agents/skills
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Después de instalar
- App de escritorio de ChatGPT: abre Skills en la barra lateral para ver que la skill está
- Para usarla: en ChatGPT escribe @ y elige la skill · en Codex CLI o la extensión del IDE ejecuta /skills o escribe $ y el nombre de la skill
- Codex detecta solo las skills recién instaladas; si una no aparece, reinicia Codex
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
ChatGPT en la web y el móvil
Las skills que instalas tú no funcionan aquí; solo las que vienen con un plugin del directorio
Para usar esta skill con ChatGPT, usa la app de escritorio de ChatGPT como se indica arriba
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Opción 1Deja que Codex lo instale
Copia esta frase y pégala en un chat de Codex · Sirve en Codex dentro de la app de escritorio de ChatGPT, en Codex CLI y en la extensión del IDE
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Codex detecta solo las skills recién instaladas; si una no aparece, reinicia Codex · Para usarla: en ChatGPT escribe @ y elige la skill · en Codex CLI o la extensión del IDE ejecuta /skills o escribe $ y el nombre de la skill
Checked against official docs 15 nov 2026 · Source: learn.chatgpt.com
Para quien usa Terminal
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Copia la carpeta del skill a ~/.agents/skills
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
Vuelve a abrir Codex y pide una tarea relacionada; Codex mostrará el skill
Opción 1Deja que Cursor lo instale
Copia esta frase y pégala en un chat de Cursor
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
En el chat Agent de Cursor escribe / y elige aqua
Checked against official docs 12 nov 2026 · Source: cursor.com
Para quien usa Terminal
Un Skill son instrucciones que la IA seguirá. Lee los archivos antes de instalar e instala solo de autores de confianza.
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: el comando no funciona en PowerShell; usa «Que la IA lo instale» arriba
Copia la carpeta del skill a ~/.cursor/skills
Descarga el repo a una carpeta temporal y copia solo las carpetas con SKILL.md
Revisando los comandos · los botones de copiar aparecen cuando pasan la revisión
En el chat Agent de Cursor escribe / y elige aqua
Opción 1Que la IA lo instale por ti
Para otras apps que leen skills. La frase incluye las rutas de Claude Code, Codex y Cursor para que la IA elija la de tu app · Copia esta frase y pégala en el chat de la aplicación
Para un solo proyecto, pégala en un chat abierto en la carpeta de ese proyecto · La IA siempre te enseña la ruta antes de instalar
La IA te dice primero qué va a hacer y te pide permiso en cada paso
Checked against official docs 12 nov 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Para quien usa Terminal
Otras apps con Agent Skills (como Gemini CLI o GitHub Copilot) usan otras carpetas. Mira la guía de esa app y copia allí la carpeta con el SKILL.md.
Carpetas de skills comprobadas con las guías oficiales de Claude Code, Codex y Cursor el 11 nov 2026
Ver el SKILL.md original
El texto siguiente viene del repo del autor, no de PopNx MCP
Se muestran los primeros 8000 caracteres · Abrir el archivo completo en GitHub
---
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:
``Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Desde GitHub
- Estrellas en GitHub
- 259
- Autor
- quailyquaily
- Licencia
- Apache-2.0
- Último cambio de código
- 24 mar 2026
- Archivos SKILL.md del repo (con traducciones y plantillas)
- 1
- Temas
- agent-skills, agent-tools, ai-agents