Wayland Protocol Skill

Apply this skill whenever a task involves Wayland concepts, even if the current wlframe codebase does not yet use that exact protocol or object family.

Primary Goal

Produce protocol-correct, lifetime-safe Wayland code and reviews:

• Model Wayland objects by protocol contract, not by incidental current usage.
• Keep object ownership, listener lifetime, and event ordering explicit.
• Respect the async nature of Wayland requests, events, roundtrips, frame callbacks, and configure/ack cycles.
• Treat wlframe integration as one application of broader Wayland rules, not the source of those rules.

Use This Skill To

• Implement or review Wayland client code using wl_display, wl_registry, wl_compositor, wl_surface, wl_shm, wl_buffer, wl_seat, wl_pointer, wl_keyboard, wl_output, and related objects.
• Work on shell protocols such as xdg_wm_base, xdg_surface, xdg_toplevel, popup flows, and output-management style extensions.
• Review buffer-sharing interop, buffer release semantics, frame callbacks, and presentation timing.
• Analyze event loops, dispatch/flush behavior, reconnect or teardown logic, and protocol version negotiation.
• Adapt wlframe to new Wayland protocols or capabilities in the future.