hammerspoon

Configure Hammerspoon macOS automation and window management with Lua scripting.

5|Updated Jan 21, 2011
One-click install
npx skills add https://github.com/minusfive/dot --skill hammerspoon-minusfive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hammerspoon
Source: https://github.com/minusfive/dot/tree/main/.claude/skills/hammerspoon
Command: npx skills add https://github.com/minusfive/dot --skill hammerspoon-minusfive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides AI-driven guidance and rules for configuring and managing macOS automation and window management using Hammerspoon Lua scripting.

Core Features & Use Cases

  • Scripting Automation: Develop and manage custom Lua scripts for automating tasks.
  • Window Management: Define and control window layouts and behavior.
  • Hotkey Configuration: Set up custom keyboard shortcuts for efficient workflow.
  • Use Case: Streamline your daily workflow by creating a hotkey that resizes and positions your terminal and browser windows to specific predefined layouts.

Quick Start

Use the hammerspoon skill to define a new hotkey that launches the calculator application using the 'meh' modifier.

Frequently Asked Questions about hammerspoon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS window management with custom keyboard shortcuts?

macOS window management automation uses Hammerspoon Lua scripting to define custom hotkeys and window layouts. You can configure modifier keys and predefined layouts to resize and position applications like browsers and terminals for efficient workflows.

What is the best way to structure Hammerspoon hotkeys using Lua scripting?

Structuring Hammerspoon hotkeys in Lua scripting requires specific modifier key definitions like 'meh' and standardized hotkey structures. Following established Spoon development patterns ensures your keyboard shortcuts integrate reliably with macOS automation workflows.

Can I use Hammerspoon Spoons to develop macOS automation scripts?

Hammerspoon Spoons support macOS automation script development by providing standardized Lua modules. You can develop Spoons following specific patterns to encapsulate window management logic and hotkey configurations into reusable components.

Do I need prior Lua scripting experience to configure macOS automation with Hammerspoon?

Configuring macOS automation with Hammerspoon requires Lua scripting knowledge to define hotkeys and window layouts. The Skill provides AI-driven rules and guidelines for Hammerspoon configuration, but understanding Lua syntax helps implement Spoon development patterns effectively.

Why are my Hammerspoon window management scripts not applying predefined layouts correctly?

Hammerspoon window management scripts fail when not adhering to specific modifier key definitions and hotkey structures. Ensure your Lua scripting follows Spoon development patterns and window management best practices to correctly position application windows.