[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EJRSS4EZPFKHW3290J72SS":3,"skill-same:01M7EJRSS4EZPFKHW3290J72SS":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7EJRSS4EZPFKHW3290J72SS","qml-ui",null,"Use when writing or changing QML in a Quickshell shell: components, bindings, delegates, layouts, Loader, Theme, exclusive zones and layer-shell windows, or exposing QML geometry to the audits. Triggers: new QML component, add a popout to my Quickshell bar, Quickshell panel overlaps maximized windows, Quickshell exclusive zone, QML Theme singleton, qmllint, qmlformat, QML delegate, QML Loader, dump the QML item tree, udelej komponentu v quickshellu, Quickshell panel prekryva okna. QML code only: shell surface behaviour, desktop rules, Hyprland config and motion forms are desktop-ui; token values are ui-design; measuring is ui-audit.","qsmark-labs\u002Fqsm-marketplace","qsmark-labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F348383745?v=4","01M7EJDK5MKZ67A7JBGC3ZB1RP","QSM-LABS","01M7EJDK6649PCGA2ENGFMFA7E",0,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-uix\u002Fskills\u002Fqml-ui\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: qml-ui\ndescription: \"Use when writing or changing QML in a Quickshell shell: components, bindings, delegates, layouts, Loader, Theme, exclusive zones and layer-shell windows, or exposing QML geometry to the audits. Triggers: new QML component, add a popout to my Quickshell bar, Quickshell panel overlaps maximized windows, Quickshell exclusive zone, QML Theme singleton, qmllint, qmlformat, QML delegate, QML Loader, dump the QML item tree, udelej komponentu v quickshellu, Quickshell panel prekryva okna. QML code only: shell surface behaviour, desktop rules, Hyprland config and motion forms are desktop-ui; token values are ui-design; measuring is ui-audit.\"\n---\n\n# QML UI\n\nQuickshell moves fast: an unaided model guesses a colour or exclusive zone and leaves nothing to\nmeasure. This skill builds on the shell's tokens, reserves the right space, and leaves a way to\nread geometry back. It is how QML is written; what a bar, popout or OSD does, the desktop rules and\nthe Hyprland config are desktop-ui. Values: ui-design, ui-palette. Names, keyboard, reduced\nmotion: a11y-audit.\n\n## Before the first line\n\n1. **Confirm the stack.** `shell.qml` with `import Quickshell` in the project, and `qs list --all`\n   shows the running instance with its config path. Anything else is not this skill.\n2. **Find the token source.** The shell's `Theme` singleton (`pragma Singleton`, usually under\n   `theme\u002F`), the `Motion` singleton when it has one, and the design source if one exists. Read\n   them and the nearest existing component; match its structure, because a second dialect is a\n   defect. With no singleton, say so and ask for the design source; never invent tokens inside a\n   component. Shell unreadable: write `Theme.\u003Crole>` and list those names as assumed.\n3. **Reuse before building.** Search the shared component library by concept before writing any\n   visible control, in a consumer of the library too, then Qt Quick Controls. When a type already\n   does the concept, use it and add the missing slot to it. A consumer never defines a control\n   named after where it is used (`PopoutRow`, `OsdSlider`): that is a second copy that drifts, and\n   a system control brings focus and keyboard handling a custom one must redo.\n4. **Open every file the owner named** (plugin, PDF, spec) before the first edit; say so in the\n   first reply if one is missing.\n\n## Rules\n\n- **No literal in a component.** Every colour, size, radius, spacing and duration is a `Theme.` \u002F\n  `Motion.` property. A missing token is added to the singleton in the design source's name with\n  its dark and light values, never a literal beside it: a literal is invisible to a theme switch\n  and to the audit's token trace.\n- **Components read roles only (ui-palette).** A component binds `Theme.accent`, never a named\n  value (`Theme.palette.mauve`); the singleton's `palette` block holds the values and a role\n  points at one. A wallpaper theme fills `palette.accent`\n  from the image, and when the derivation finds no hue the singleton fails loud with the image\n  path rather than mapping `accent` to a neutral. Check: `grep -rn 'palette\\.' components\u002F`\n  prints nothing.\n- **Pairs travel together.** A fill token and its on-token (`primary` \u002F `onPrimary`) are read\n  together in one item; never copy a colour into a local `property color`.\n- **Durations and easing come from the motion tokens** (`Motion`, else `Theme`; with none, say so\n  and ask). Reduced motion is clamped in the singleton, nowhere else: a component that bypasses\n  it breaks the setting for the whole shell. How a surface animates is desktop-ui. A tappable item\n  reads `TapHandler.pressed`.\n- **Integer geometry.** A fractional `x`\u002F`y`\u002F`width` blurs a 1 px edge. Round computed sizes\n  (`Math.round`, `Math.ceil` for text). Position with `anchors` or `Layout`, never both on one\n  item; `Layout` where the content drives the parent.\n- **Reserved space is an exclusive zone, never a margin.** A bar or dock is a `PanelWindow` anchored\n  to its edge. `exclusionMode: ExclusionMode.Auto` (the default) derives the zone from the window's\n  size and anchors; setting `exclusiveZone` switches the window to `Normal`, which reads that\n  number; `Ignore` reserves nothing and is right only for overlays. A zone needs one anchored edge,\n  or three (a full-width bar). Content windows never paint into reserved space: a margin that\n  mimics a bar's width breaks when the bar changes.\n- **One window set per output.** `Variants { model: Quickshell.screens }` with the screen as\n  `required property var modelData`, and `screen: modelData` on the window. A window made once\n  lands on one monitor, the usual reason a panel overlaps windows on the second.\n- **Scale is per output.** Tree coordinates are logical, a screenshot is physical: divide by\n  the output's `scale` (`hyprctl monitors -j`).\n- **Expose what an assistive tool needs.** Interactive custom items get `Accessible.role`,\n  `Accessible.name`, and a keyboard path (`activeFocusOnTab`, `Keys.onReturnPressed`, visible\n  focus): a bare `MouseArea` is invisible to both.\n\n## Libraries\n\n- `Quickshell.Services.*` for system state: Pipewire (volume, devices), Mpris (players), UPower\n  (battery), SystemTray, Notifications. Check the [Quickshell API](https:\u002F\u002Fquickshell.org\u002Fdocs\u002F)\n  for the installed version first.\n- `Quickshell.Hyprland` for workspaces, the focused client, `GlobalShortcut` (`hyprctl` for the\n  rest); `Quickshell.Io` for `Process`, `FileView`, sockets, `IpcHandler`; `Quickshell.Wayland`\n  for layer-shell options and toplevels.\n- Qt Quick Controls and Layouts for controls and sizing, `MultiEffect` (Qt 6.5+) for blur and\n  shadow, never `QtGraphicalEffects`; pointer handlers (`TapHandler`, `HoverHandler`,\n  `DragHandler`) over `MouseArea`, whose exclusive grabs steal touch.\n- A customised `contentItem`, `background`, `indicator` or `handle` needs a named style import\n  (`QtQuick.Controls.Basic`), or the default style renders over it.\n\n## Conventions\n\nQt's QML conventions and the qt-qml-review checklist, the stricter where they differ:\n\n- **Declaration order in an object** (checklist ORD-1): `id` (`id: root` on a component's top\n  item), property assignments, property declarations, signal declarations, attached properties,\n  `states`, `transitions`, signal handlers, child objects (visual first), functions. Group related\n  properties (`anchors { }`, `font { }`).\n- **Bindings:** never assign a property in JavaScript when it has a binding: the assignment replaces\n  it for good and `qmllint` does not catch it; restore it with `Qt.binding(() => expr)`. Typed\n  properties (`int`, `string`, `color`), never `property var` for typed data. `readonly property`\n  caches an expensive expression; `let` or `const` and `===` in JS; never anchor to an invisible\n  item or across unrelated branches, and never size by `implicitWidth` bindings that feed back.\n- **Delegates:** `required property` for model data; once one exists `index` and `modelData` are\n  no longer injected, so declare them too. `pragma ComponentBehavior: Bound` when a delegate\n  reads outer ids. No nested Repeaters or several Loaders in one. In a delegate `parent` is its\n  internal container, not the view: use `ListView.view` or an id. `currentIndex` starts at 0, not\n  -1, once a model is set: reset it when no item should be current.\n- **Layouts:** never set `width` or `height` on a Layout child (use `Layout.preferredWidth` and\n  the like) and never `x` or `y`: the first breaks size negotiation, the second is ignored. A\n  reusable component sets `implicitWidth` and `implicitHeight`.\n- **Connections:** always set `target` (the default is `parent`, which changes with the parent\n  type). Write `function onFoo()`, not `onFoo:`.\n- **Lifetime:** guard on `Loader.status`; never switch a Loader between `source` and\n  `sourceComponent`. Never `Qt.createQmlObject` (it parses a string on every call) and never\n  `Qt.createComponent` with a string URL (not type-safe): use a `Component` or a typed URL. Hold\n  a `createObject()` result in a variable or give it a parent, or the GC can take it; destroy it\n  when done.\n- **Hiding:** `visible: false` removes an item from rendering and input; `opacity: 0` keeps both,\n  so a closed popout still takes the pointer.\n- **States:** a `Transition` states its `from` and `to`, or it fires on every state change. A\n  reusable component with states uses `StateGroup`, not top-level `states`.\n- **Cost:** `Image` gets `sourceSize` and `asynchronous: true`; `Text.PlainText` unless rich; avoid\n  a transparent `Rectangle` and `clip` unless measured. `layer.enabled: true` caches a texture and\n  costs GPU memory: only on an expensive item, measured.\n\n## Stress and variants\n\n- Worst-case data: a debug singleton every model reads through one binding, flipped over IPC and\n  gated on an environment variable: `IpcHandler { target: \"debug\"; function data(mode: string):\n  void { Debug.data = mode; } }`, then `qs ipc -p \u003Cshell.qml> call debug data worst`. A bar module\n  fed a title wider than itself elides (`elide: Text.ElideRight`, bounded `Layout.maximumWidth`);\n  a `Layout.fillWidth` text needs `Layout.minimumWidth: 0` or it pushes siblings off.\n- Variants: a `variant` property on that singleton read by a `Loader` per component, flipped by\n  `IpcHandler { target: \"proto\"; ... }` (`call proto pick 2`). Variants live outside the\n  production import path; replay sets `active` to false, then true.\n- `font.letterSpacing` is in pixels: convert tracking from em.\n\n## Make it checkable\n\nQuickshell has no item-tree dump, so the shell exposes one through an `IpcHandler`; use the\nshell's own if it has one (`qs ipc -p \u003Cshell.qml> show` lists targets; look for `inspect`), else\nadd this and nothing more:\n\n```qml\nfunction dump(item: var): var {\n    const o = item.mapToItem(null, 0, 0);\n    const e = { type: String(item).split(\"(\")[0].replace(\u002F^QQuick\u002F, \"\"),\n                x: o.x, y: o.y, w: item.width, h: item.height };\n    if (item.objectName !== \"\") e.name = item.objectName;\n    if (item.color !== undefined) e.color = String(item.color);\n    if (item.radius !== undefined) e.radius = item.radius;\n    const kids = Array.from(item.children, c => dump(c));\n    if (kids.length) e.children = kids;\n    return e;\n}\nIpcHandler { target: \"probe\"\n             function tree(): string { return JSON.stringify(dump(win.contentItem)); } }\n```\n\n`win` is a window's `id`. Read it with `qs ipc -p \u003Cshell.qml> call probe tree | jq`; use `-p` or\n`-c`, because a bare `qs ipc` looks for a `default` config. Positions are window-relative logical\npixels. Give the items under test an `objectName`. Reserved space: `hyprctl monitors -j | jq '.[]\n| {name, scale, reserved}'` (`reserved` is left, top, right, bottom). Hand both to ui-audit as\nlive geometry.\n\n## Gates, in this order\n\n1. `qmlformat -i \u003Cfile>`.\n2. `qmllint \u003Cfile>`, clean. Without import paths it may report Quickshell and `qs.*` types as not\n   found (`-I \u003Cdir>` points it at qmltypes); read any other warning as real. Fix warnings, do not\n   silence them.\n3. Run the shell only when the owner asked (`qs -p \u003Cshell.qml>`, then dump the tree). Otherwise end\n   with \"Not verified on the composed surface\" and list each owner check as surface, route,\n   expected state: geometry read from code is a hypothesis, and lint proves syntax only, so never\n   write \"works\" for pointer, hover, focus or animation behaviour.\n\n## Red flags\n\n- When a panel overlaps windows on one monitor, read `reserved`, the window's anchors and\n  `exclusionMode` for that output before touching a margin: the cause is nearly always a zone or\n  a missing per-output window.\n- When `qmllint` is clean but the surface renders empty, read `qs log`: lint misses runtime type\n  failures.\n- When a property or id is named `on\u003CCapital>`, or `size`, `radius`, `live` on an Item, rename\n  it: it crashes the load or drops the config silently.\n\n## Say it in the reply\n\n- The tokens used and any added.\n- The `qmlformat` \u002F `qmllint` result, whether the surface was run (or the owner checks), and the\n  dump target and `objectName`.\n- For reserved space: the `reserved` numbers before and after, or that they were not read.\n","# QML UI\n\nQuickshell moves fast: an unaided model guesses a colour or exclusive zone and leaves nothing to\nmeasure. This skill builds on the shell's tokens, reserves the right space, and leaves a way to\nread geometry back. It is how QML is written; what a bar, popout or OSD does, the desktop rules and\nthe Hyprland config are desktop-ui. Values: ui-design, ui-palette. Names, keyboard, reduced\nmotion: a11y-audit.\n\n## Before the first line\n\n1. **Confirm the stack.** `shell.qml` with `import Quickshell` in the project, and `qs list --all`\n   shows the running instance with its config path. Anything else is not this skill.\n2. **Find the token source.** The shell's `Theme` singleton (`pragma Singleton`, usually under\n   `theme\u002F`), the `Motion` singleton when it has one, and the design source if one exists. Read\n   them and the nearest existing component; match its structure, because a second dialect is a\n   defect. With no singleton, say so and ask for the design source; never invent tokens inside a\n   component. Shell unreadable: write `Theme.\u003Crole>` and list those names as assumed.\n3. **Reuse before building.** Search the shared component library by concept before writing any\n   visible control, in a consumer of the library too, then Qt Quick Controls. When a type already\n   does the concept, use it and add the missing slot to it. A consumer never defines a control\n   named after where it is used (`PopoutRow`, `OsdSlider`): that is a second copy that drifts, and\n   a system control brings focus and keyboard handling a custom one must redo.\n4. **Open every file the owner named** (plugin, PDF, spec) before the first edit; say so in the\n   first reply if one is missing.\n\n## Rules\n\n- **No literal in a component.** Every colour, size, radius, spacing and duration is a `Theme.` \u002F\n  `Motion.` property. A missing token is added to the singleton in the design source's name with\n  its dark and light values, never a literal beside it: a literal is invisible to a theme switch\n  and to the audit's token trace.\n- **Components read roles only (ui-palette).** A component binds `Theme.accent`, never a named\n  value (`Theme.palette.mauve`); the singleton's `palette` block holds the values and a role\n  points at one. A wallpaper theme fills `palette.accent`\n  from the image, and when the derivation finds no hue the singleton fails loud with the image\n  path rather than mapping `accent` to a neutral. Check: `grep -rn 'palette\\.' components\u002F`\n  prints nothing.\n- **Pairs travel together.** A fill token and its on-token (`primary` \u002F `onPrimary`) are read\n  together in one item; never copy a colour into a local `property color`.\n- **Durations and easing come from the motion tokens** (`Motion`, else `Theme`; with none, say so\n  and ask). Reduced motion is clamped in the singleton, nowhere else: a component that bypasses\n  it breaks the setting for the whole shell. How a surface animates is desktop-ui. A tappable item\n  reads `TapHandler.pressed`.\n- **Integer geometry.** A fractional `x`\u002F`y`\u002F`width` blurs a 1 px edge. Round computed sizes\n  (`Math.round`, `Math.ceil` for text). Position with `anchors` or `Layout`, never both on one\n  item; `Layout` where the content drives the parent.\n- **Reserved space is an exclusive zone, never a margin.** A bar or dock is a `PanelWindow` anchored\n  to its edge. `exclusionMode: ExclusionMode.Auto` (the default) derives the zone from the window's\n  size and anchors; setting `exclusiveZone` switches the window to `Normal`, which reads that\n  number; `Ignore` reserves nothing and is right only for overlays. A zone needs one anchored edge,\n  or three (a full-width bar). Content windows never paint into reserved space: a margin that\n  mimics a bar's width breaks when the bar changes.\n- **One window set per output.** `Variants { model: Quickshell.screens }` with the screen as\n  `required property var modelData`, and `screen: modelData` on the window. A window made once\n  lands on one monitor, the usual reason a panel overlaps windows on the second.\n- **Scale is per output.** Tree coordinates are logical, a screenshot is physical: divide by\n  the output's `scale` (`hyprctl monitors -j`).\n- **Expose what an assistive tool needs.** Interactive custom items get `Accessible.role`,\n  `Accessible.name`, and a keyboard path (`activeFocusOnTab`, `Keys.onReturnPressed`, visible\n  focus): a bare `MouseArea` is invisible to both.\n\n## Libraries\n\n- `Quickshell.Services.*` for system state: Pipewire (volume, devices), Mpris (players), UPower\n  (battery), SystemTray, Notifications. Check the [Quickshell API](https:\u002F\u002Fquickshell.org\u002Fdocs\u002F)\n  for the installed version first.\n- `Quickshell.Hyprland` for workspaces, the focused client, `GlobalShortcut` (`hyprctl` for the\n  rest); `Quickshell.Io` for `Process`, `FileView`, sockets, `IpcHandler`; `Quickshell.Wayland`\n  for layer-shell options and toplevels.\n- Qt Quick Controls and Layouts for controls and sizing, `MultiEffect` (Qt 6.5+) for blur and\n  shadow, never `QtGraphicalEffects`; pointer handlers (`TapHandler`, `HoverHandler`,\n  `DragHandler`) over `MouseArea`, whose exclusive grabs steal touch.\n- A customised `contentItem`, `background`, `indicator` or `handle` needs a named style import\n  (`QtQuick.Controls.Basic`), or the default style renders over it.\n\n## Conventions\n\nQt's QML conventions and the qt-qml-review checklist, the stricter where they differ:\n\n- **Declaration order in an object** (checklist ORD-1): `id` (`id: root` on a component's top\n  item), property assignments, property declarations, signal declarations, attached properties,\n  `states`, `transitions`, signal handlers, child objects (visual first), functions. Group related\n  properties (`anchors { }`, `font { }`).\n- **Bindings:** never assign a property in JavaScript when it has a binding: the assignment replaces\n  it for good and `qmllint` does not catch it; restore it with `Qt.binding(() => expr)`. Typed\n  properties (`int`, `string`, `color`), never `property var` for typed data. `readonly property`\n  caches an expensive expression; `let` or `const` and `===` in JS; never anchor to an invisible\n  item or across unrelated branches, and never size by `implicitWidth` bindings that feed back.\n- **Delegates:** `required property` for model data; once one exists `index` and `modelData` are\n  no longer injected, so declare them too. `pragma ComponentBehavior: Bound` when a delegate\n  reads outer ids. No nested Repeaters or several Loaders in one. In a delegate `parent` is its\n  internal container, not the view: use `ListView.view` or an id. `currentIndex` starts at 0, not\n  -1, once a model is set: reset it when no item should be current.\n- **Layouts:** never set `width` or `height` on a Layout child (use `Layout.preferredWidth` and\n  the like) and never `x` or `y`: the first breaks size negotiation, the second is ignored. A\n  reusable component sets `implicitWidth` and `implicitHeight`.\n- **Connections:** always set `target` (the default is `parent`, which changes with the parent\n  type). Write `function onFoo()`, not `onFoo:`.\n- **Lifetime:** guard on `Loader.status`; never switch a Loader between `source` and\n  `sourceComponent`. Never `Qt.createQmlObject` (it parses a string on every call) and never\n  `Qt.createComponent` with a string URL (not type-safe): use a `Component` or a typed URL. Hold\n  a `createObject()` result in a variable or give it a parent, or the GC can take it; destroy it\n  when done.\n- **Hiding:** `visible: false` removes an item from rendering and input; `opacity: 0` keeps both,\n  so a closed popout still takes the pointer.\n- **States:** a `Transition` states its `from` and `to`, or it fires on every state change. A\n  reusable component with states uses `StateGroup`, not top-level `states`.\n- **Cost:** `Image` gets `sourceSize` and `asynchronous: true`; `Text.PlainText` unless rich; avoid\n  a transparent `Rectangle` and `clip` unless measured. `layer.enabled: true` caches a texture and\n  costs GPU memory: only on an expensive item, measured.\n\n## Stress and variants\n\n- Worst-case data: a debug singleton every model reads through one binding, flipped over IPC and\n  gated on an environment variable: `IpcHandler { target: \"debug\"; function data(mode: string):\n  void { Debug.data = mode; } }`, then `qs ipc -p \u003Cshell.qml> call debug data worst`. A bar module\n  fed a title wider than itself elides (`elide: Text.ElideRight`, bounded `Layout.maximumWidth`);\n  a `Layout.fillWidth` text needs `Layout.minimumWidth: 0` or it pushes siblings off.\n- Variants: a `variant` property on that singleton read by a `Loader` per component, flipped by\n  `IpcHandler { target: \"proto\"; ... }` (`call proto pick 2`). Variants live outside the\n  production import path; replay sets `active` to false, then true.\n- `font.letterSpacing` is in pixels: convert tracking from em.\n\n## Make it checkable\n\nQuickshell has no item-tree dump, so the shell exposes one through an `IpcHandler`; use the\nshell's own if it has one (`qs ipc -p \u003Cshell.qml> show` lists targets; look for `inspect`), else\nadd this and nothing more:\n\n```qml\nfunction dump(item: var): var {\n    const o = item.mapToItem(null, 0, 0);\n    const e = { type: String(item).split(\"(\")[0].replace(\u002F^QQuick\u002F, \"\"),\n                x: o.x, y: o.y, w: item.width, h: item.height };\n    if (item.objectName !== \"\") e.name = item.objectName;\n    if (item.color !== undefined) e.color = String(item.color);\n    if (item.radius !== undefined) e.radius = item.radius;\n    const kids = Array.from(item.children, c => dump(c));\n    if (kids.length) e.children = kids;\n    return e;\n}\nIpcHandler { target: \"probe\"\n             function tree(): string { return JSON.stringify(dump(win.contentItem)); } }\n```\n\n`win` is a window's `id`. Read it with `qs ipc -p \u003Cshell.qml> call probe tree | jq`; use `-p` or\n`-c`, because a bare `qs ipc` looks for a `default` config. Positions are window-relative logical\npixels. Give the items under test an `objectName`. Reserved space: `hyprctl monitors -j | jq '.[]\n| {name, scale, reserved}'` (`reserved` is left, top, right, bottom). Hand both to ui-audit as\nlive geometry.\n\n## Gates, in this order\n\n1. `qmlformat -i \u003Cfile>`.\n2. `qmllint \u003Cfile>`, clean. Without import paths it may report Quickshell and `qs.*` types as not\n   found (`-I \u003Cdir>` points it at qmltypes); read any other warning as real. Fix warnings, do not\n   silence them.\n3. Run the shell only when the owner asked (`qs -p \u003Cshell.qml>`, then dump the tree). Otherwise end\n   with \"Not verified on the composed surface\" and list each owner check as surface, route,\n   expected state: geometry read from code is a hypothesis, and lint proves syntax only, so never\n   write \"works\" for pointer, hover, focus or animation behaviour.\n\n## Red flags\n\n- When a panel overlaps windows on one monitor, read `reserved`, the window's anchors and\n  `exclusionMode` for that output before touching a margin: the cause is nearly always a zone or\n  a missing per-output window.\n- When `qmllint` is clean but the surface renders empty, read `qs log`: lint misses runtime type\n  failures.\n- When a property or id is named `on\u003CCapital>`, or `size`, `radius`, `live` on an Item, rename\n  it: it crashes the load or drops the config silently.\n\n## Say it in the reply\n\n- The tokens used and any added.\n- The `qmlformat` \u002F `qmllint` result, whether the surface was run (or the owner checks), and the\n  dump target and `objectName`.\n- For reserved space: the `reserved` numbers before and after, or that they were not read.\n",{"name":5,"description":7},"main","c385fc50aadaee7296445e049153ce0560a9c80c","plugins\u002Fqsm-uix\u002Fskills\u002Fqml-ui","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace","https:\u002F\u002Fgithub.com\u002Fqsmark-labs","2026-11-13 18:31:51",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add qsmark-labs\u002Fqsm-marketplace --skill qml-ui",{"tool":36,"command":37},"bunx","bunx skills add qsmark-labs\u002Fqsm-marketplace --skill qml-ui",{"tool":39,"command":40},"pnpm","pnpm dlx skills add qsmark-labs\u002Fqsm-marketplace --skill qml-ui","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-uix\u002Fskills\u002Fqml-ui\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":19},"01M7EJWPJ0B4E1P148MWQ3GMR8","worktrunk","Use when working with git worktrees or wt (worktrunk): creating, switching, merging or removing a branch workspace, configuring wt (project or personal config, workflow hooks around switch, commit and merge, commit-message generation, hook approvals), or a wt command that failed. Triggers: make a worktree for this branch, wt merge, wt remove, configure wt, .config\u002Fwt.toml, run tests before merge, install deps when a worktree is created, wt hook, wt switch does not cd, nastav wt, wt nefunguje.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-worktrunk\u002Fskills\u002Fworktrunk\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7EJWD4F683TF21N89JGWZB2","web-ladder","Use when a task needs something the internet holds: look something up, search the web, find which page answers a question, read a page, check a library's current docs, a page that needs a browser or shows a captcha. Runs one research loop: searxng search, keywords, cases, search again up to three times, Context7 for a library, Tavily when the keywords will not come, one page in a browser, the person on a wall. Triggers: look this up, search the web, find out online, read this page, check the docs, the page is blocked, captcha, najdi na webu, otevri tu stranku. A multi-round question goes to the qsm-web:web-research agent; one tool's commands are its own skill (searxng, browserbox, opensrc).","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fweb-ladder\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7EJW9G0K6AS5Z4H0B0K6NDB","searxng","Use when running a web search through the person's own SearXNG instance with qsm-web searxng: choosing a search profile or engines, the instance, time range or language, reading its JSON, a suspended engine. Triggers: search with searxng, qsm-web searxng, search profile, niche search, academic search, IT search, vyhledavaci profil, searxng is down, which engines. The research loop around it is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fsearxng\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7EJW40RD3DRBQVVCW6K7NMG","opensrc","Use when the source code of an open-source library or repository is needed on disk to read: the docs are silent, the behaviour must be checked in code, the version the project pins. Runs qsm-web opensrc get with a package spec or a repository address. Triggers: get the source of this package, clone this library, read the library's code, qsm-web opensrc, stahni zdrojak knihovny. Library docs are the Context7 skill; the research loop is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fopensrc\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7EJVZWD6J7W91G69GMBWBQS","browserbox","Use when one page needs a real browser through qsm-web browserbox: content built by script, a page that blocks plain fetching, a captcha to solve or hand to the person, a scripted sequence of clicks, a login the person is present for. Triggers: open it in a browser, the page is empty without JavaScript, captcha, take over the browser, run these steps on the page, log in to this site, browserbox. When to reach for a browser at all is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fbrowserbox\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7EJVSZC1E8ZGVE8KXVFPR9S","usage","Use when the user wants a review of how they use Claude Code, or setup hands over after a first install: review my Claude Code usage, audit my setup, what does my setup cost, where did my tokens go, clean up my Claude Code, usage report, zkontroluj moje pouzivani. One walkthrough of four stages (machine, work, habits, extensions), questions after each, then one plan. A question about one topic (which hooks are slow) goes to that topic's skill; this session's tokens alone is `\u002Fqsm-usage`.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-usage\u002Fskills\u002Fusage\u002FSKILL.md",[],[]]