Printer not working or print queue stuck
Skill: printer-repair · Risk: medium · Steps: 10
Diagnoses and repairs printing issues including stuck print queues, offline printers, and CUPS/Spooler service failures. Clears jammed queues and restarts the print service; guides self-service + IT escalation for driver/config corruption.
What it does, step by step
Step 1. Lists all installed printers and reports each one’s current status and type.
read-only · list_printers
Step 2. Scans every print queue for stuck, error, or held jobs.
read-only · check_print_queue
Step 3. Asks for the printer’s IP address or hostname when it can’t be found automatically. no tools, conditional
Step 4. Tests whether the printer responds on the network to determine if it’s a connectivity or software issue.
read-only, conditional · check_printer_connectivity
Step 5. Clears stuck print jobs from all queues after showing which jobs will be cancelled.
deletes data, asks permission, preview first, conditional · clear_print_queue
Step 6. Confirms whether the queue is now empty after clearing stuck jobs.
read-only, conditional · check_print_queue
Step 7. Restarts the print service when a printer is offline, stopped, or jobs keep sticking.
deletes data, asks permission, preview first, conditional · restart_cups
Step 8. Rechecks printer status after the restart and flags likely driver or configuration corruption if unresolved.
read-only, conditional · list_printers
Step 9. Asks the user to send a real test print and confirm whether it succeeded.
asks the user, conditional · wait_for_user_ack
Step 10. Summarizes what was checked and fixed, the final status, and any next steps needed. no tools
Tools it may use
list_printers, check_print_queue, check_printer_connectivity, clear_print_queue, restart_cups, request_user_input, wait_for_user_ack