notify-gchat-human-waitlisted
Install: claude install-skill samuhs/mad-science
# Send Google Chat notification — human waiting
Sends a text card to the Google Chat space configured in the repository when
work is blocked waiting for a human response, so the user notices without
returning to the terminal.
## When to use — decided by the repository policy
This skill only implements **how** to notify. The **when** (which skills and
conditions trigger it) is defined in the repository's `CLAUDE.md`, in the
section describing flow skills. If a flow skill is in progress and the turn is
waiting for human input, call this skill to notify. Otherwise, do not call it.
Do not notify for waiting on processing, script execution, or system actions —
only when a **human** needs to respond.
## How to call
From the repository root (where `.env` lives), run — `<skill-dir>` is the
directory containing this `SKILL.md` (it differs per agent and install method):
```bash
bash <skill-dir>/scripts/notify-gchat.sh \
"the question awaiting a response" ["project name"] ["waiting"|"done"]
```
- Argument 2 is optional: without it, the script uses the `basename` of the
repository root (the project folder name).
- Argument 3 is optional and selects the card header: `waiting` (default) for a
question awaiting a human, `done` for a finished stage/experiment.
The bash script is a **thin wrapper**: it only reads `GCHAT_WEBHOOK_URL` from
`.env` and delegates to `scripts/notify_gchat.py`, which builds the payload.
Formatting lives in Python — not in bash — because the card is a