linux-desktop

Controls the XFCE Linux desktop, LibreOffice apps, and terminal through scripted GUI automation.

2|Updated May 12, 2026
One-click install
npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill linux-desktop-tajo9128
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linux-desktop
Source: https://github.com/tajo9128/BioDockify-Pharma-AI/tree/main/plugins/_desktop/skills/linux-desktop
Command: npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill linux-desktop-tajo9128

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xdotool, xclip, libreoffice, and includes scripts (resource) components.

What problem does it solve? Operating GUI applications like LibreOffice Writer, Calc, Impress, the Thunar file manager, and terminal emulators requires visual interaction that structured file tools cannot perform. This Skill gives the agent an observe-act-verify control loop over the persistent XFCE desktop so it can launch apps, focus windows, send keystrokes, paste text, edit spreadsheet cells live, and verify results from screenshots. ## Core Features & Use Cases - Desktop Control Script: The desktopctl.sh helper wraps xdotool to launch apps, focus windows, click, type, paste, scroll, drag, and capture screenshots against the persistent agent-zero-desktop X display. - Live Calc Editing: The calc-set-cell command opens an XLSX in the visible LibreOffice Calc session via UNO, edits a cell, saves, and verifies the value on disk so users see updates in real time. - Structured State Observation: observe --json --screenshot returns window titles, active window, and a fresh screenshot for verification after every GUI action. - Use Case: A user asks to update a budget spreadsheet and confirm the change visually. The agent launches Calc, sets the cell through the UNO bridge, saves the workbook, and captures a final screenshot as proof. ## Quick Start Ask the agent to open LibreOffice Calc on the Linux desktop, set cell B2 in your workbook to a new value, save it, and show a screenshot confirming the change.

Frequently Asked Questions about linux-desktop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control a Linux desktop GUI from an AI agent?

Use the desktopctl.sh helper script, which wraps xdotool to launch apps, focus windows, send keystrokes, paste text, and capture screenshots against the persistent X display. Always observe the desktop state before acting and verify with a fresh screenshot afterward.

How to edit a LibreOffice Calc cell programmatically while the file is open?

Run desktopctl.sh calc-set-cell with the file path, sheet name, cell reference, and value. It connects to the running LibreOffice session over the UNO socket, sets the cell, saves the workbook, and verifies the value written to the XLSX on disk.

Does this desktop automation work without opening the visible desktop surface?

The persistent desktop runtime can run in the background, but visible surface use is opt-in. Structured tools like document_artifact are preferred for deterministic file edits, and the desktop is used only for GUI-only actions and visual confirmation.

Why does desktopctl.sh report the X display is not reachable?

This happens when the desktop runtime session is not ready or xdotool cannot connect to the configured DISPLAY. Open the Desktop surface first and rerun the check command rather than installing packages or retrying clicks blindly.

When should coordinate clicks be avoided in GUI automation?

Coordinate clicks are a last resort because they break when windows move or resize. Prefer app launches, window focus, keyboard shortcuts, paste-text, and app-native helpers like calc-set-cell, and only click after a fresh screenshot observation.