goal-watcheslisted
Install: claude install-skill shannonbay/Quarterdeck
# Watches for Quarterdeck goals
A goal runs on a schedule. A **watch** also starts a run when something new appears. You set one with `update_goal` (`watches`); the person sees the whole command and confirms it.
## How a watch works
- A watch is a shell command (or, for a connector, a tool: see below), run every few minutes (`every_minutes`, default 5, at least 1) in the goal's working directory.
- The command prints **one line per current item**: an issue number, a feed entry's id, a file name. It exits 0.
- A line it has not printed before is new. New lines queue a run, and that run's brief lists them under `watch_events`.
- The first check only records what is there. It starts nothing.
- A check that fails (non-zero exit or longer than 30 seconds) changes nothing and starts nothing. After three failures in a row the Goals pane shows the watch as failing.
- Several new lines, or lines that arrive while a run is going, make one run, not one each.
So print **stable identifiers**, not text that changes. A line with a comment count or a "2 hours ago" in it looks new at every check.
## Writing the command
1. Run the command yourself first, in the goal's directory, and read what it prints.
2. Check it prints nothing but item lines on stdout. Stderr is ignored, except to explain a failure.
3. Check it exits non-zero when the source can't be reached. Otherwise an outage reads as "no items", which is harmless, but a half-printed list is not.
4. Keep it to at most 200 lines of