From a7cda4bc05100bb1cb31598a1483ac9ceb6b6730 Mon Sep 17 00:00:00 2001
From: Vishal T <54330666+vish727@users.noreply.github.com>
Date: Mon, 28 Sep 2026 02:02:41 -0400
Subject: [PATCH] docs: say that a scheduled job wakes the nook, and what it
 costs

---
 skill/SKILL.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/skill/SKILL.md b/skill/SKILL.md
index 7b5be04..6d5ed5b 100644
--- a/skill/SKILL.md
+++ b/skill/SKILL.md
@@ -189,7 +189,11 @@ schedule.
   until every declared name is set, and the deploy says which are missing.
 - `egress` is every host the code may reach. Anything not listed is blocked. Leave it out and the
   nook has no outbound network at all.
-- `cron` runs a command on a schedule, in UTC, five fields, at most five entries.
+- `cron` runs a command on a schedule, in UTC, five fields, at most five entries. A scheduled job
+  wakes the nook: it runs whether or not anyone is using it, and it does not need the nook's own
+  page to have been opened. The nook stays awake for about ten minutes after a job finishes, and
+  longer while one is still running, so an entry every minute keeps it awake all the time and a
+  nightly entry costs about ten minutes a night.
 
 Add `"source": "viewers"` if you want anyone who can open the nook to read its code; by default
 that is the owner and its editors, because code on a server never reaches a browser the way a