Printer

Print images and PDFs to any CUPS printer. PPD-aware: reads paper sizes, margins, resolution, and duplex at runtime. Use when the user wants to print files (...

Security Scan

The skill's code, declared requirements, and runtime instructions align with its stated purpose of printing files via the local CUPS stack; it does not request secrets or perform network I/O and its use of subprocesses is appropriate for calling lp/lpstat/lpoptions.

Purpose & Capability

Name/description ask for CUPS printing. Required binaries (python3, lp, lpstat, lpoptions) and dependency (Pillow) are exactly what a CUPS-aware printing tool needs. The pyproject dependency and script are proportional to the task.

Instruction Scope

SKILL.md tells the agent to run the included script which lists printers, queries PPDs, converts images to PDFs and invokes lp to submit jobs. The script's filesystem and command usage are limited to paths and tools relevant to printing (PPD files, workspace/tmp, and lp).

Install Mechanism

No install spec — instruction-only with a bundled script. No downloads or archive extraction. This minimizes install-time risk.

Credentials

No credentials requested. The script honors an optional OPENCLAW_WORKSPACE env var to allow printing only from workspace paths; this is reasonable but means the agent will trust that environment variable when allowing files. No other env vars are accessed.

Persistence & Privilege

always is false and the skill does not request system-wide changes or other skills' credentials. The script writes temporary PDF files when converting images (uses tempfile with delete=False), which is normal for this functionality.

Assessment

This skill appears to do what it says: it reads local CUPS PPDs, converts images with Pillow, and calls lp/lpstat/lpoptions. Before installing: 1) Confirm you run it on a machine with CUPS and trust the system printers (jobs go to local/network printers). 2) Be careful with the OPENCLAW_WORKSPACE env var — if set to a sensitive directory it will allow printing files from there; prefer leaving it unset or pointing to a dedicated workspace. 3) The script creates temporary PDF files (delete=False) — you may want to review or clean /tmp after use. 4) Review the included script if you need to be extra cautious; there are no network calls or secret exfiltration patterns visible. Overall the skill is coherent and proportional to its stated purpose.

Print images and PDF files to any CUPS printer. All settings (paper size, margins, resolution, duplex) are read from the printer's PPD file at runtime.

Entry point: {baseDir}/scripts/print.py

Setup

See SETUP.md for prerequisites and platform notes.

Commands

List Printers

python3 {baseDir}/scripts/print.py list
python3 {baseDir}/scripts/print.py list --json

Shows available printers with status and which is the system default.

Print a File

python3 {baseDir}/scripts/print.py print /path/to/file.pdf
python3 {baseDir}/scripts/print.py print /path/to/image.png
python3 {baseDir}/scripts/print.py print /path/to/file.pdf --printer "Custom_Printer"
python3 {baseDir}/scripts/print.py print /path/to/file.pdf -o InputSlot=tray-2
python3 {baseDir}/scripts/print.py print /path/to/file.pdf -o cupsPrintQuality=High -o sides=one-sided
python3 {baseDir}/scripts/print.py print /path/to/file.pdf --json

• PDFs: Sent directly to the printer with correct media/duplex settings
• Images (PNG, JPG, GIF, BMP, TIFF, WebP): Converted to PDF at the printer's native DPI, centered within the printable area, then printed
• -o KEY=VALUE: Pass any CUPS option (repeatable). Use options to discover available settings (tray, quality, media type, duplex, color mode).
• Symlinks are followed but the resolved path must be inside the workspace or /tmp

Printer Info

python3 {baseDir}/scripts/print.py info
python3 {baseDir}/scripts/print.py info --printer "Custom_Printer"
python3 {baseDir}/scripts/print.py info --json

Shows manufacturer, model, resolution, color support, default paper, duplex mode, input trays, and all paper sizes with margins.

Printer Options

python3 {baseDir}/scripts/print.py options
python3 {baseDir}/scripts/print.py options --printer "Custom_Printer"
python3 {baseDir}/scripts/print.py options --json

Shows all CUPS options with current values and available choices.

Notes

• Uses the system default printer unless --printer is specified
• All commands support --json for machine-readable output
• Image conversion respects the printer's imageable area (margins) from the PPD
• Only printable file types accepted: PDF, PNG, JPG, GIF, BMP, TIFF, WebP

Tips

Tray / Media Selection

Some PPDs have empty InputSlot command strings, so -o InputSlot=tray-2 alone may not work. Use the combined media keyword instead:

# Print to a specific tray with media type
python3 {baseDir}/scripts/print.py print envelope.pdf -o media=A6,tray-2,envelope

# Format: -o media=SIZE,TRAY,TYPE
# SIZE: A4, A5, A6, EnvDL, EnvC5, Letter, etc.
# TRAY: tray-1, tray-2, auto
# TYPE: stationery, envelope, cardstock, labels, etc.

This passes tray selection via IPP directly, bypassing the PPD.