This repository has no description
1.4 kB
39 lines
1---
2name: notify
3description: Get the user's attention by speaking a short message via TTS and posting a desktop notification. Use when a long-running task finishes, when you need input to continue, or when something needs human attention.
4---
5
6# Notify Skill
7
8Use `s say` to alert the user — it speaks via flite TTS and posts a desktop
9notification. `s` is the superconfig launcher; it resolves the flake and runs
10the tool, so you don't need to know where the checkout lives.
11
12## Usage
13
14```bash
15s say "build finished, all tests green"
16s say "need your input on the migration plan"
17s say # default: "Attention requested."
18```
19
20## When to use
21
22- A long-running build, test, or deploy just finished — tell the user the
23 outcome.
24- You hit a question that requires a human decision and can't proceed without
25 it.
26- An error or unexpected state needs review before you continue.
27
28## When NOT to use
29
30- Routine updates that the user can read in the transcript at their own pace.
31- Inside tight loops or after every tool call — the user will tune it out.
32- For anything sensitive: the message is spoken aloud and shown on the desktop,
33 so don't read out secrets, tokens, or private data.
34
35## Tips
36
37- Keep messages short — one sentence is plenty. flite reads slowly.
38- Lead with the outcome ("tests passed", "deploy failed", "need input"), not
39 the context.