🧰 Agent skills

An organiser wallpaper draws the boxes. A skill lets your assistant actually move the icons into them.

New to agents? The Guide explains the setup in plain language.

Wallpaper maker skill

How to use the MCP server well: creating from your notes and gallery examples, monitor sets, sharing, icon plans, weekly routines, and the rules that never bend. Pairs with the arrangement skill below.

⬇ Download skill

unzip wallpaper-maker.zip -d ~/.claude/skills/

Icon arrangement skill

Reads a wallpaper's screen map, works out which bay each file belongs in, and moves the icons there. Dry-run by default, with one-command undo.

⬇ Download skill

Install it

unzip desktop-tidy.zip -d ~/.claude/skills/

That's the folder Claude Code reads skills from. Other agent platforms take the same layout — a SKILL.md plus its scripts.

Make an organiser wallpaper

Choose an organizer in Explore, such as Weekly reset or Project runway, and customize it in the Workshop. Download the wallpaper with agent setup; the screen map also rides along inside the PNG.

Ask

"Tidy my icons to match ~/Pictures/desk.png"

It shows you every move before touching anything. Say yes and the icons land in their bays.

What's in the box

desktop-tidy/
├── SKILL.md                  what the agent reads
├── scripts/
│   ├── desk.py               map · scan · plan · undo   (macOS)
│   └── tidy_windows.ps1      Windows legacy prototype — not a supported adapter
└── reference/
    └── screen-map.md         the map schema

The macOS tool does the mechanical parts — reading the map, listing visible files, converting wallpaper pixels into screen coordinates, driving the OS. The agent does the judgement: that Q3-forecast-v2-FINAL.xlsx belongs in Finance and not Scratch.

Safety

Nothing moves without --apply. The default is a printed plan.
Undo is written first. The macOS tool snapshots the previous positions to ~/.fwm-desktop-tidy/.
Files are never renamed, moved on disk, or deleted. Only their icon positions change. Script launchers are never run as part of arranging them.
Unsure files stay put. Anything the agent can't categorise is left alone rather than guessed at.

What can your agent do today?

Using the image as wallpaper is separate from arranging real icons. The latter needs a local tool that understands your computer, display scaling and permissions. These are capability assessments, not a claim that every OS version or physical display has been tested.

Best supported path in this app

macOS · Finder

The bundled desktop-tidy tool reads and positions Finder icons using AppleScript, previews labeled-bay assignments and saves positions for undo. That existing adapter makes macOS the most practical starting point here.

In Finder, choose Sort By → None, turn off Stacks when placing individual files, and allow the trusted tool to control Finder under Privacy & Security → Automation. Match the actual display and icon-label size; preview the plan before applying it.

Multiple-display selection exists in the tool, but unusual scaling, wallpaper cropping and changing displays still need a real on-screen check. GUI-driven agents may need their own additional permissions.

Apple: arrange icons · Automation permissions

Needs a compatible Windows adapter

Windows · Explorer

Windows can support programmatic icon placement. Microsoft documents a Shell interface for it, so this is feasible for a suitable native tool or agent.

The included PowerShell file is an unverified legacy prototype. It uses direct ListView messages; Microsoft warns that this approach can lose position changes on modern Windows. It is not our recommended setup path.

Use manual arrangement or an adapter based on the supported Shell interface. Check auto-arrange settings, display scaling, preview and recovery in that tool. This app has not verified a production Windows adapter.

Microsoft: supported icon positioning

Depends on the window manager

Linux · Plasma, GNOME and others

Linux setups vary. KDE Plasma offers Folder View, and GNOME setups may use an extension such as DING. Their icon ownership, arrangement controls and agent access differ.

There is no bundled Linux placement adapter. Ask an agent to identify the window manager and icon extension, then confirm a supported way to read, position and restore icons. Manual arrangement remains useful; a universal Linux automation claim would be misleading.

KDE: Folder View · GNOME: DING icon extension

The bundled tool handles labeled bays. Open-area icon placement and wallpaper installation can require separate capabilities. Keep the current wallpaper settings and icon positions before making changes; arranging an icon never means running its script.

Building your own integration instead? The map is public JSON — see /agents.