Skip to content
cccskills
FreePublished on GitHub

pueue

This skill should be used before running non-interactive long-running tasks, computation intensive tasks, background tasks, or needs guidance on the pueue CLI tool usage. TRIGGER when user says "use pueue", "run in background", "queue this task", or when about to run any long-running (>2 min) task.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode
See how to install

Files included (3)

  • SKILL.md2.5 KB
  • references/pueue.md3.9 KB
  • scripts/run_in_pueue.sh1.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Pueue - Background Task Manager

When to Use

  • Non-interactive long-running tasks expected to run for >2 minutes
  • Computation intensive tasks with parallel job scheduling (prevent resource exhaustion)
  • Tasks that should continue even if you disconnect

When NOT to Use

  • Short tasks (<2 minutes): run directly
  • Interactive commands: use tmux instead for TUI access

Workflow

Option 1: Add and Follow (Recommended)

Start task and follow its output (blocks until complete):

# Add task and get its ID
pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'

# Follow task output (blocks until complete)
pueue follow <task_id>

Option 2: Add and Check Later

Start task without blocking, check status later:

# Add task
pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'

# Later, check status
pueue status

# View output when done
pueue log <task_id>

Option 3: Using the Helper Script

scripts/run_in_pueue.sh 'PYTHONUNBUFFERED=1 uv run python -u train.py'

This script:

  • Auto-starts daemon if needed
  • Creates a project-specific group
  • Adds the task and follows output

Conversation Example

User: Start training in the background.

Assistant:

pueue add 'PYTHONUNBUFFERED=1 uv run python -u train.py'

Then I'll follow the output:

pueue follow <task_id>

Training started. I'll monitor progress and report when complete.

Quick Reference

CommandDescription
pueue statusList all tasks
pueue add 'cmd'Queue a task
pueue follow <id>Follow task output (blocks)
pueue log <id>View completed task output
pueue kill <id>Kill a running task
pueue cleanRemove finished tasks

Key Pitfalls

  • Always quote the command: pueue add 'cmd --flag' not pueue add -- cmd --flag
  • Python needs unbuffered output: Use PYTHONUNBUFFERED=1 or python -u
  • Use project groups: pueue add -g myproject 'cmd' to avoid mixing tasks

Skill Files

  • scripts/run_in_pueue.sh — wraps pueue add with auto daemon start, per-project grouping, and follow
  • references/pueue.md — comprehensive pueue CLI usage documentation

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-browser

Free

Browser automation CLI for AI agents. Use when needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. TRIGGER when user requests to "open a website", "fill out a form", "click a button", "take a screenshot", "debug this in browser", "scrape data from a page", "test this web app", "login to a site", "frontend UI/UX aesthetics", "automate browser actions", or any task requiring programmatic web interaction.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

anti-defensive

Free

Review common AI slops of defensive programming patterns, avoid silent errors. TRIGGER when reviewing code for defensive anti-patterns, writing fail-fast code, or auditing error handling quality.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

ast-grep

Free

Guide for writing ast-grep rules to perform structural code search and analysis. This skill should be used when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search, or when a simple grep/glob search is insufficient for structural code pattern matching.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

better-translate

Free

Best practices for AI-driven English-to-Chinese translation. This skill should be used when the user asks to "translate to Chinese", "update the Chinese translation", "improve Chinese translation", "fix translation quality", "review Chinese translation", or when translating any English text into Chinese. Also applies when polishing an existing Chinese translation of English content.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

bilibili-api

Free

This skill should be used when the user asks to "use bilibili API", "download bilibili video", "get bilibili user info", "list bilibili favorites", "send bilibili danmaku", "upload video to bilibili", "monitor bilibili live room", "search bilibili", "get bilibili comments", or needs guidance on the bilibili_api Python library usage, authentication, API endpoints, or workflow patterns.

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

cc-connect

Free

This skill should be used when sending images, files, or notifications back to the user via messaging platforms (Discord, Feishu, Telegram, etc.) through cc-connect. TRIGGER when agent generates a plot/chart/screenshot and wants to show the user; agent creates a report/PDF/file the user should receive; agent needs to proactively notify the user (e.g. task completed, alert, reminder); user asks to "send image", "show me the chart", "notify me", "send the file", "send to Telegram", "show plot in Discord".

The English summary is being prepared. Showing the original description.

archibate/dotfiles-opencode108Updated Apr 29, 2026

See all skills by archibate

Report a problem with this skill