← Back to Skills Marketplace
wallpaper-auto-switch-pro-executable
by
vx:17605205782
· GitHub ↗
· v1.0.0
· MIT-0
297
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install wallpaper-auto-switch-pro-executable
Description
在 macOS 本机从本地壁纸文件夹中立即换壁纸,或安装 launchd 定时轮换任务的可执行技能。
Usage Guidance
This skill largely matches its description, but take these precautions before running or installing: 1) Fix the shuf/gshuf mismatch — either install GNU coreutils (providing gshuf) or edit scripts to call the correct shuf binary on your system. 2) Inspect and (preferably) edit common.sh's expand_path() to avoid eval; use a safe expansion method (e.g., expand ~ without eval) to eliminate command-injection risk from untrusted path strings. 3) Run list_images.sh first to verify it finds only intended files. 4) Be aware install_launchagent.sh will create ~/Library/LaunchAgents/com.openclaw.wallpaperrotator.plist and start a per-user launchd job; uninstall_launchagent.sh will remove that plist. 5) When scripts call osascript, macOS may prompt for automation accessibility permissions; review prompts before granting. If you cannot audit or modify the scripts yourself, avoid installing the LaunchAgent and run rotate_once.sh manually with a trusted, simple path to minimize risk.
Capability Analysis
Type: OpenClaw Skill
Name: wallpaper-auto-switch-pro-executable
Version: 1.0.0
The skill automates macOS wallpaper rotation using local bash scripts and launchd for persistence. It contains a shell injection vulnerability in `scripts/common.sh` where the `eval` command is used to expand tilde (~) paths without input sanitization, potentially allowing arbitrary command execution if a malicious path is provided. While the functionality aligns with the stated purpose and no evidence of intentional malice or data exfiltration was found, the insecure handling of path inputs poses a significant security risk.
Capability Assessment
Purpose & Capability
The skill's name/description (macOS wallpaper rotator) matches the provided scripts and expected behavior: immediate rotation, listing images, installing/uninstalling a per-user launchd job. However there's an inconsistency in declared dependencies: metadata lists gshuf while the scripts call shuf. On macOS shuf is not present by default (Homebrew coreutils installs it as gshuf). This mismatch will likely cause runtime failures unless the user has the expected binary or adjusts the scripts.
Instruction Scope
The SKILL.md and scripts stay within the claimed scope (operate only on a user-specified directory, write plist to ~/Library/LaunchAgents, use osascript to set desktop picture, do not contact the network). However common.sh's expand_path() uses eval to expand input (eval "printf '%s' $input"), which can execute shell content if the provided path contains shell metacharacters—this is a command-injection risk if an attacker or a mistaken agent supplies a crafted directory string. The rest of the scripts avoid deleting user files and only write to user-scoped locations, as claimed.
Install Mechanism
This is an instruction-only skill with included scripts; there is no remote download or install routine. Nothing is fetched from external URLs or written to system-wide locations during 'install' beyond the user's LaunchAgents directory when the install script is run. That is lower risk than arbitrary downloads.
Credentials
The skill declares no environment variables or external credentials, which is appropriate. It uses $HOME and id -u for user-scoped operations, which is expected. The only proportionality issue is the binary name mismatch (gshuf vs shuf) between metadata/README and the actual scripts; the user may need to install GNU coreutils (gshuf) or modify scripts to call the available shuf/gshuf.
Persistence & Privilege
The skill does not request 'always: true' and will not be force-included. Its persistence comes from writing a LaunchAgent plist under the current user's ~/Library/LaunchAgents and using launchctl to bootstrap it — this is expected for a per-user automated task. The scripts only modify their own plist and user-scoped logs, not system-wide configuration or other skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install wallpaper-auto-switch-pro-executable - After installation, invoke the skill by name or use
/wallpaper-auto-switch-pro-executable - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: introduces a macOS-only executable skill for local wallpaper auto-switching.
- Supports immediate random wallpaper change, checking available images, installing/uninstalling periodic launchd tasks.
- Does not support Internet wallpaper fetching or Windows/Linux/WeChat/mobile environments.
- Real command execution required for any success message—no fake confirmations.
- Requires bash, osascript, find, and shuf binaries on macOS.
- Designed for users who already maintain a local wallpaper directory.
Metadata
Frequently Asked Questions
What is wallpaper-auto-switch-pro-executable?
在 macOS 本机从本地壁纸文件夹中立即换壁纸,或安装 launchd 定时轮换任务的可执行技能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 297 downloads so far.
How do I install wallpaper-auto-switch-pro-executable?
Run "/install wallpaper-auto-switch-pro-executable" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is wallpaper-auto-switch-pro-executable free?
Yes, wallpaper-auto-switch-pro-executable is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does wallpaper-auto-switch-pro-executable support?
wallpaper-auto-switch-pro-executable is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created wallpaper-auto-switch-pro-executable?
It is built and maintained by vx:17605205782 (@52yuanchangxing); the current version is v1.0.0.
More Skills