Skip to content
Skills Library
Programming · Building & coding

widget

/widget

Create, update, hide, show, list, and delete Übersicht desktop widgets on macOS. Use this skill whenever the user asks for desktop widgets, desktop gadgets, or widgets.

Licence
MIT
Last repository change
20.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
17
Scripts
15
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 15 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/doctor.sh, scripts/install-widget.sh, scripts/list-widgets.sh, scripts/setup.sh, scripts/start-uebersicht.sh, templates/clock.jsx, templates/git-pulse.jsx, templates/horizon-clock.jsx

What it does and when to use it

Create, update, hide, show, list, and delete Übersicht desktop widgets on macOS. Use this skill whenever the user asks for desktop widgets, desktop gadgets, or widgets.

Arguments

/widget [operation, e.g. add a clock / hide the pomodoro / list all widgets]
Original author description

Create, update, hide, show, list, and delete Übersicht desktop widgets on macOS. Use this skill whenever the user asks for desktop widgets, desktop gadgets, or widgets.

How it works

  1. Environment
  2. First Step
  3. Reference Files
  4. Hard Constraints
  5. Operations
  6. Widget Format
  7. Required Rules
  8. Position Cheatsheet
  9. Built-In Templates
  10. Style Baseline
Original SKILL.md headings · 236 lines, 1,045 words
SKILL.md preview
---
name: widget
description: Create, update, hide, show, list, and delete Übersicht desktop widgets on macOS. Use this skill whenever the user asks for desktop widgets, desktop gadgets, or widgets.
argument-hint: "[operation, e.g. add a clock / hide the pomodoro / list all widgets]"
allowed-tools: Bash(bash *), Bash(cp *), Bash(mv *), Bash(rm *), Bash(ls *), Write, Edit
---

# WidgetDesk Skill

## Environment
- Widget directory: `~/Library/Application Support/Übersicht/widgets/`
- Template directory: `~/.claude/skills/widget/templates/` after install, or `.claude/skills/widget/templates/` inside this repo
- Host requirement: Übersicht is installed and available at `/Applications/Übersicht.app` or `/Applications/Uebersicht.app`

## First Step
- When working inside a WidgetDesk repo clone, run `bash scripts/setup.sh` first
- `scripts/setup.sh` is the default entrypoint: it installs missing host dependencies, starts Übersicht, prepares the widget directory, installs the skill, and verifies the result
- Use `bash scripts/setup.sh --check` only when the user explicitly wants a dry-run check or when you are diagnosing an installation problem
- Use `bash ~/.claude/skills/widget/scripts/doctor.sh` only for a fast post-install health check
- After setup, use the installed skill path under `~/.claude/skills/widget/`

## Reference Files
- Reusable implementation patterns: [patterns.md](patterns.md)
- Host management scripts: `scripts/` for setup, starting Übersicht, checking the environment, installing widgets, and listing widgets

---

## Hard Constraints

### 1. Layout
- All widgets should default to `position: fixed`
- Any bottom-aligned widget must keep `bottom >= 90px`
- Default edge spacing is `40px`
- Default width should stay within `140px` to `360px`
- Default height should stay within `48px` to `220px`
- Only exceed these dimensions when the user explicitly asks for a large widget

### 2. Interaction
- Display-only widgets should default to `pointer-events: none`
- Only enable interaction when the widget truly needs clicking, dragging, or text input
- Interactive controls must stay easy to hit
- Avoid complex multi-step desktop interactions by default

### 3. Refresh
- Command-driven widgets should normally refresh between `1000ms` and `600000ms`
- Refresh below `1000ms` only for clocks or clearly time-sensitive UI
- Pure frontend widgets should use `refreshFrequency = false`
- Avoid high-frequency network requests

### 4. Implementation
- Use lowercase kebab-case filenames
- Prefer existing templates and `patterns.md` before inventing new structure
- Prefer built-in macOS capabilities over extra dependencies
- Do not hardcode secrets
- Keep widgets single-file by default unless the user explicitly asks for more complexity

### 5. Visual Style
- Keep the style consistent, restrained, and macOS-like
- Default to dark translucent cards
- Recommended corner radius: `14px` to `20px`
- Prefer `SF Pro Display` and `SF Mono`
- Keep motion short, light, and purposeful
- Do not invent a brand-new visual language for every widget

---

## Operations

```bash
# First-time setup inside this repo
bash scripts/setup.sh
bash scripts/setup.sh --check

# Fast post-install health check
bash ~/.claude/skills/widget/scripts/doctor.sh

# Start Übersicht
bash ~/.claude/skills/widget/scripts/start-uebersicht.sh

# Install or update a template widget
bash ~/.claude/skills/widget/scripts/install-widget.sh \
  ~/.claude/skills/widget/templates/clock.jsx

# List installed widgets
bash ~/.claude/skills/widget/scripts/list-widgets.sh

# Write a brand-new custom widget
cat > ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx << 'EOF'
{widget_code}
EOF

# Hide a widget without deleting it
mv ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx \
   ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx.disabled

# Show a hidden widget
mv ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx.disabled \
   ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx

# Delete a widget
rm ~/Library/Application\ Support/Übersicht/widgets/{name}.jsx
```

Prefer the `scripts/` helpers for host operations. Only write raw widget files directly when creating or replacing actual JSX content.

When the user asks for a standard widget that already exists as a built-in template, do not rewrite it from scratch. Run `scripts/setup.sh` if needed, then install the matching template.
Do not install or copy any widget file until `scripts/setup.sh` has completed successfully and the host app is available.

---

## Widget Format

```jsx
// Optional shell command. stdout is passed into render as output.
export const command = "date '+%H:%M:%S'"

// Refresh frequency in milliseconds. Pure frontend widgets should use false.
export const refreshFrequency = 1000

// CSS positioning. Use position: fixed.
export const className = `
  position: fixed;
  bottom: 90px;
  right: 40px;
`

// render receives { output, error }
export const render = ({ output }) => {
  return <div>{output?.trim()}</div>
}
```

---

## Required Rules

### Rule 1: Never import React from `react`
```jsx
// Bad
import { useState } from 'react'

// Good
import { React } from 'uebersicht'
```

### Rule 2: Never call hooks directly inside `render`
```jsx
// Bad
export const render = () => {
  const [n, setN] = React.useState(0)
}

// Good
const Widget = () => {
  const { useState } = React
  const [n, setN] = useState(0)
  return <div>{n}</div>
}

export const render = () => <Widget />
```

### Rule 3: Never return a function from a state updater
```jsx
// Bad
setRemaining(r => {
  if (r <= 1) return p => p === 'work' ? BREAK : WORK
})

// Good
useEffect(() => {
  if (remaining !== 0) return
  setPhase(p => p === 'work' ? 'break' : 'work')
  setRemaining(p => p === 'work' ? BREAK : WORK)
}, [remaining])
```

---

## Position Cheatsheet

| Position | CSS |
|----------|-----|
| Bottom right | `bottom: 90px; right: 40px;` |
| Bottom left | `bottom: 90px; left: 40px;` |
| Top right | `top: 40px; right: 40px;` |
| Top left | `top: 40px; left: 40px;` |

---

## Built-In Templates

| File | Purpose | Default Position |
|------|---------|------------------|
| `clock.jsx` | Clock and date | Bottom right |
| `horizon-clock.jsx` | Alternate horizontal clock | Bottom right |
| `pomodoro.jsx` | Pomodoro timer | Bottom left |
| `now-playing.jsx` | Apple Music now playing | Bottom center |
| `system-stats.jsx` | CPU, memory, battery | Top right |
| `weather-canvas.jsx` | Animated weather card | Top left |
| `git-pulse.jsx` | Local Git activity heatmap | Top right |
| `memo-capsule.jsx` | Local quick-note capsule | Top center |
| `volume-knob.jsx` | System volume control knob | Right side |
| `tap-counter.jsx` | Simple interactive counter with persisted local state | Bottom right |

Copy a template directly when it already matches the request, or use it as the starting point for a custom widget.

---

## Style Baseline

```css
background: rgba(8, 12, 20, 0.72);
backdrop-filter: blur(24px);
-webkit-backdrop-filter: blur(24px);
border-radius: 18px;
border: 1px solid rgba(255, 255, 255, 0.08);
box-shadow: 0 14px 40px rgba(0, 0, 0, 0.35);
font-family: -apple-system, BlinkMacSystemFont, 'SF Pro Display', sans-serif;
color: rgba(255, 255, 255, 0.92);
```

Add this for display-only widgets:

```css
pointer-events: none;
```

---

## Useful macOS Shell Commands

```bash
date '+%H:%M:%S'
date '+%Y年%-m月%-d日 %A'
pmset -g batt | grep -o '[0-9]*%' | head -1
top -l 1 | grep "CPU usage" | awk '{print $3}'
curl -s "wttr.in/?format=%t+%C"
```

Remember to `.trim()` command output before rendering it.
Files in this package (17)
  • SKILL.md 7 KB
  • patterns.md 4 KB
  • scripts/doctor.sh 1 KB
  • scripts/install-widget.sh 1 KB
  • scripts/list-widgets.sh 1 KB
  • scripts/setup.sh 6 KB
  • scripts/start-uebersicht.sh 1 KB
  • templates/clock.jsx 1 KB
  • templates/git-pulse.jsx 11 KB
  • templates/horizon-clock.jsx 9 KB
  • templates/memo-capsule.jsx 7 KB
  • templates/now-playing.jsx 7 KB
  • templates/pomodoro.jsx 4 KB
  • templates/system-stats.jsx 3 KB
  • templates/tap-counter.jsx 5 KB
  • templates/volume-knob.jsx 6 KB
  • templates/weather-canvas.jsx 13 KB

Versions

RepositoryScoreLicence
This page · LeoYeAI/openclaw-master-skills100MIT
muon-m2/magento2-tools100MIT

Database snapshot: 13.11.2026 · package version 778ba26e6f73 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100list-widgets
    This skill should be used when the user wants to list existing dashboard widgets in a Langfuse project, show widgets, see what widgets exist, get a widget inventory, or understand which widgets are deployed on which dashboards. Trigger phrases include "list widgets", "show…
  • 100widget-generator
    Generate WidgetKit widgets for iOS/macOS home screen and lock screen with timeline providers, interactive elements, and App Intent configuration. Use when adding widgets to an app.
  • 100orchardcore-widgets
    Skill for creating and managing widgets in Orchard Core. Covers widget content types, zones, layers, layer rules, widget placement configuration, Widget shape templates and wrappers, safe rendering of widget HTML, and ManageLiquidTemplates for Liquid widgets. Use this skill when…
  • 100wear-widgets
    Create, migrate, update, and verify Wear OS widgets using Glance Wear and Remote Compose in an Android project. Use this skill when implementing GlanceWearWidget, GlanceWearWidgetService, WearWidgetDocument, Remote Compose UI primitives (RemoteColumn, RemoteRow, RemoteBox,…
  • 100umg-widgets
    Create and modify UMG Widget Blueprints (UI) — build the widget hierarchy, set properties, style fonts/brushes, author widget animations, bind events, capture previews, run PIE checks, and wire MVVM ViewModels. Use when the user asks to create a UI/HUD/menu, add or arrange…
  • 100pythonide-widget
    Create or repair PythonIDE iOS Home Screen widgets using widget.Widget(), widget.param, widget.state, charts, tables, canvas layouts, and family branching. Use when the user asks for a WidgetKit widget, desktop widget script, or widget preview — not an AppUI MiniApp.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.