Skip to content

docs: add filename convention and shell aliases to queue skill #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mtibbits wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: add filename convention and shell aliases to queue skill #37

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7dce53c
docs: add filename convention, shell aliases, and remove unsupported …
mtibbits Mar 31, 2026
b6d7ce9
docs: restore "0 = highest" priority clarification in table
mtibbits Mar 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 30 additions & 2 deletions src/claude_code_queue/skills/queue/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down Expand Up @@ -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 (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. |
Expand Down Expand Up @@ -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'
```