diff --git a/SKILL.md b/SKILL.md
index 2826cfe..11874bb 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -164,16 +164,12 @@ follow-ups in an agent queue when they are not part of the current request.
 ```sh
 tsk queue current
 tsk queue list
-tsk queue create claude
-tsk queue create review -p
 tsk queue switch claude
 tsk --queue review list
 ```
 
 - `queue current` prints the active queue.
 - `queue list` lists known queues.
-- `queue create <name>` creates a queue; add `-p` to allow other queues to pull
-  from it.
 - `queue switch <name>` changes the active queue.
 - `--queue <name>` overrides the active queue for one invocation.
 
diff --git a/readme b/readme
index 0692ec4..5e67ef1 100644
--- a/readme
+++ b/readme
@@ -71,6 +71,11 @@ Tasks are marked as "completed" and removed from the index with the `tsk drop`
 command. They will remain in the .tsk/archive folder, but are excluded from
 fuzzy searches by default.
 
+Queues are independent ordered stacks. Create one with `tsk queue create NAME`;
+new queues default to `can-pull=false`, which prevents other queues from
+pulling tasks out of them. Use `tsk queue create -p NAME` to create a pullable
+queue, or `tsk queue can-pull NAME true|false` to change that flag later.
+
 The priority of a task may be manipulated in any of several ways:
 
 `tsk swap` swaps the top two task on the stack