From 7dce53c79b6de3202640f6b4099799dcb18bfd0f Mon Sep 17 00:00:00 2001 From: Matthew Tibbits Date: Tue, 31 Mar 2026 04:31:12 +0000 Subject: [PATCH 1/2] docs: add filename convention, shell aliases, and remove unsupported attribute from queue skill - Document the filename prefix convention (unique alphanumeric ID before first dash) and recommend zero-padded numeric prefixes for batch jobs so ls order matches execution order - Add recommended shell aliases for queue monitoring (wQueue, wqStat) - Remove unsupported `allowed-tools` frontmatter attribute that produced a runtime warning Co-Authored-By: Claude Opus 4.6 Signed-off-by: Matthew Tibbits --- src/claude_code_queue/skills/queue/SKILL.md | 32 +++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) diff --git a/src/claude_code_queue/skills/queue/SKILL.md b/src/claude_code_queue/skills/queue/SKILL.md index 0fbec7f..7bd20dd 100644 --- a/src/claude_code_queue/skills/queue/SKILL.md +++ b/src/claude_code_queue/skills/queue/SKILL.md @@ -8,7 +8,6 @@ description: > automatically with retry. Triggers on: "queue this", "add to queue", "run later", "rate limit", "prompt bank", "save as template", "batch of tasks", "claude-queue". -allowed-tools: [Bash, Read, Glob] argument-hint: "[task description or subcommand]" disable-model-invocation: false --- @@ -79,11 +78,28 @@ Background, constraints, or requirements. What should be delivered when done. ``` +### Filename Convention + +Template filenames **must** start with a unique alphanumeric prefix +(the prompt ID), followed by a `-` and a descriptive name. The prompt +ID is everything before the first `-` in the filename. + +When creating batches of jobs, use zero-padded numeric prefixes that +match the `priority` field so that `ls` order equals execution order: + +``` +0001-Fix-auth-bug.md # priority: 1, runs first +0002-Add-logging.md # priority: 2, runs second +0003-Update-tests.md # priority: 3, runs third +``` + +Use 4-digit padding for batches under 10,000 jobs. + ### Frontmatter Fields | Field | Notes | |---|---| -| `priority` | **0 = highest**. Lower number executes first. | +| `priority` | Lower number executes first. For batches, match to the filename prefix. | | `working_directory` | Absolute path. Use the actual project path from context. | | `context_files` | Paths relative to `working_directory`. Only include files that exist. | | `max_retries` | Total attempts: `3` = 3 total, `-1` = unlimited, `1` = no retry. Rate-limit retries and failures share this counter. | @@ -177,3 +193,15 @@ reruns on restart. Prompt users to design queued tasks to be idempotent **Always suggest** running `claude-queue status --detailed` before starting the daemon so the user can review what will execute. + +## Recommended Shell Aliases + +Add these to `~/.bashrc` or `~/.zshrc` for convenient queue monitoring: + +```bash +# Watch the queue directory (see jobs arrive, execute, and disappear) +alias wQueue='pushd $HOME/.claude-queue/queue; watch ls' + +# Watch queue daemon state (current job, retry status, etc.) +alias wqStat='watch cat $HOME/.claude-queue/queue-state.json' +``` From b6d7ce90072640c7f7aebb8af924a76d426cd7d7 Mon Sep 17 00:00:00 2001 From: Matthew Tibbits Date: Tue, 31 Mar 2026 04:31:55 +0000 Subject: [PATCH 2/2] docs: restore "0 = highest" priority clarification in table Co-Authored-By: Claude Opus 4.6 Signed-off-by: Matthew Tibbits --- src/claude_code_queue/skills/queue/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/claude_code_queue/skills/queue/SKILL.md b/src/claude_code_queue/skills/queue/SKILL.md index 7bd20dd..4fee251 100644 --- a/src/claude_code_queue/skills/queue/SKILL.md +++ b/src/claude_code_queue/skills/queue/SKILL.md @@ -99,7 +99,7 @@ Use 4-digit padding for batches under 10,000 jobs. | Field | Notes | |---|---| -| `priority` | Lower number executes first. For batches, match to the filename prefix. | +| `priority` | Lower number executes first (0 = highest). For batches, match to the filename prefix. | | `working_directory` | Absolute path. Use the actual project path from context. | | `context_files` | Paths relative to `working_directory`. Only include files that exist. | | `max_retries` | Total attempts: `3` = 3 total, `-1` = unlimited, `1` = no retry. Rate-limit retries and failures share this counter. |