queue-task

Claude Queue Task Creator

This skill helps users quickly create tasks for claude-queue when approaching Claude Plan usage limits. It enables users to queue remaining work and walk away while tasks run unattended.

When to Use This Skill

Proactively suggest creating tasks when:

• Multiple large code changes have been made in the session
• Long conversation with many tool uses
• User mentions they have more work to do
• Complex refactoring or multi-step task is in progress
• User explicitly says: "queue this", "create tasks", "I'm hitting limits"

Don't wait for user to hit limits - be proactive and help them avoid interruption.

Proactive Suggestion Template

When you notice significant work has been done, say:

"We've made good progress, but we're likely approaching your usage limits. Would you like me to create tasks for the remaining work? That way you can queue it up and let it run unattended."

List what tasks you could create and ask for confirmation.

Task Creation Approach

For Single Tasks

Provide a CLI command:

./claude-queue.py add "Task description" \
  --working-dir ~/path/to/project \
  --priority 10

For Multiple Tasks or Dependencies

Use the Write tool to create a YAML file directly in the project directory. Don't provide copy-paste commands - create the file immediately.

Task File Format

tasks:
  - prompt: "Clear, specific task description"
    session: "task-session-name"
    working_dir: "~/path/to/project"
    priority: 10
    max_attempts: 3
    depends_on: ["other-session-name"]  # optional

Priority Guidelines

• Critical/Blockers: 15-20
• High priority: 10-14
• Normal: 5-9
• Low priority: 1-4
• Nice to have: 0

Task Description Best Practices

Good descriptions:

• Clear and specific: "Refactor auth module to use OAuth2, update all endpoints"
• Include acceptance criteria: "Add error handling and write tests for edge cases"
• Self-contained: "Fix bug in user registration - email validation not working for +addresses"