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