Can I use this for web application testing?

No, this skill is specifically designed for native macOS applications. For web testing, you should use the Chrome or Playwright skills.

Is it compatible with AppleScript?

While Hammerspoon is the preferred tool for its reliability and Lua integration, this skill focuses on Hammerspoon and cliclick for automation tasks.

What is the '6-gate' reminder in the documentation?

It is a strict TDD protocol requiring the skill to Build, Launch, Wait, Check Process, Read Logs, and Verify Logs before performing any UI interactions to ensure test reliability.

Does this require additional software installed on my Mac?

Yes, it requires the Hammerspoon application and its CLI tools (hs) to be installed and granted Accessibility permissions.

How does it handle visual verification of tests?

The skill uses the macOS screencapture CLI and Hammerspoon’s snapshot features to provide visual evidence of test results, which is a mandatory part of the E2E workflow.

macOS Desktop Automation

Name: macOS Desktop Automation
Author: edwinhu

byedwinhu

0•

Security & Testing

Automates native macOS application testing and desktop workflows using Hammerspoon and system-level input simulation.

This skill empowers Claude to perform end-to-end testing and sophisticated automation on native macOS applications. By leveraging Hammerspoon's Lua-based scripting engine, it enables precise window management, menu interaction, and simulated keyboard/mouse inputs. The skill includes rigorous safety checks through a mandatory 6-gate TDD protocol, ensuring applications are built and running correctly before executing UI tests. It is an essential tool for developers who need to verify native Mac software behavior, manage complex multi-app workflows, or capture visual evidence of application states.

Key Features

01Simulated keyboard and mouse inputs including complex modifiers

02Advanced window management and precise screen positioning

030 GitHub stars

04Native macOS application launch and lifecycle control

05Automated menu item interaction and clipboard verification

06Integrated visual verification with automated screenshot capture

Use Cases

01Automating repetitive multi-application desktop workflows

02End-to-end (E2E) testing for native macOS desktop applications

03Debugging UI states and verifying application behavior via system logs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add edwinhu/workflows dev-test-hammerspoon

For use in Claude.ai and ChatGPT

Download Skill