3 -description: Use when building Wayland desktop components with Quickshell (status bars, widgets, OSDs, lockscreens, Greetd login, Polkit agent, app launchers) on Hyprland/Sway/i3/Niri. Triggers on "quickshell", "qs shell", "qml bar", "qtquick panel", "make me a bar/widget/lockscreen with quickshell", "add a module to my quickshell config".
3 +description: Use when building Wayland desktop components in QML with the Quickshell toolkit — status bars, widgets, OSDs, lockscreens, Greetd greeter, Polkit agent, system tray, app launchers, notification daemons. Runs on Hyprland/Sway/i3/Niri (wlroots-based compositors) and X11 best-effort. Triggers on "quickshell", "qs shell", "quickshell config", "qs ipc", "qtquick bar", "qt panel", "build me a bar with quickshell", "make a quickshell widget", "add a module to my quickshell config". NOT for: configuring Hyprland itself (see `hypr` skill), configuring Niri (see `niri` skill), Ironbar configs (see `ironbar` skill), or general QML language questions (see `qml` skill).
3 +Each example in this directory is a **minimal, runnable** Quickshell shell. They were derived from the patterns documented in the [official Quickshell examples repo](https://git.outfoxxed.me/quickshell/quickshell-examples) and the [official Quickshell docs](https://quickshell.org/docs/v0.3.0/). They are written from scratch, not copies.
14 +| 06 | `06-ipc-control/` | `IpcHandler` for external control | `quickshell.org/docs/v0.3.0/guide/faq/` "Open/close windows with commands" section | Same as the quickshell project: LGPL-3.0 |
15 +| 07 | `07-composite-bar/` | All five services in one bar | Composite of patterns from `examples/02`, `04`, `quickshell-examples/activate_linux/` (Variants + namespace), `quickshell-examples/focus_following_panel/` (Hyprland API) | Same as the quickshell project: LGPL-3.0 |
16 +| 08 | `08-notification-daemon/` | `NotificationServer` + `Repeater` on `trackedNotifications` | `quickshell.org/docs/v0.3.0/types/Quickshell.Services.Notifications/NotificationServer` + replaces mako/dunst | Same as the quickshell project: LGPL-3.0 |
34 +All 8 examples validated against `qs 0.3.0` (Arch Linux package, 2026-06-16). Each example loads with `INFO: Configuration Loaded` and no `ERROR` lines in the log.
39 +- **Quickshell examples repo**: no explicit LICENSE file. The maintainer is the same as the quickshell project; intent ("Simple quickshell examples to learn from and modify") is project-permissive. Examples are not copies — they're minimal rewrites following the same patterns.
40 +- **This skill (`pi-ext/skills/quickshell/`)**: same license as the parent `pi-ext` repo.
42 +The example QML files in this directory are written from scratch based on the documented Quickshell patterns. They are not direct copies of the official examples. For anything more than a few lines, prefer studying the upstream examples directly at <https://git.outfoxxed.me/quickshell/quickshell-examples>.