ClautoHotkey

Generate a complete AHK v2 GUI from a natural language description. Creates class-based, mathematically positioned GUIs with proper event binding. TRIGGER when: user says "generate a GUI", "build me a window", "create a dialog", "make a form", "design a settings panel", "build a tool with UI".

COM automation and interop for AHK v2 — driving Excel / Word / WMI / Internet Explorer via IDispatch, COM events, ComValue / SafeArrays, and direct vtable ComCall. Use when automating another application, wiring COM events, or calling a COM interface. TRIGGER when: user says "automate Excel/Word", "COM object", "ComObject", "ComCall", "WMI query", "COM event", "IDispatch", "SafeArray", "ComValue", "VARIANT". Examples: "automate Excel from AHK", "query WMI for processes", "hook IE navigation events"

Native calls and raw memory for AHK v2 — DllCall to Windows/native APIs, Buffer + NumGet/NumPut for structs, StrPut/StrGet, CallbackCreate, and the alpha.30 typed Struct. Use when calling a DLL/WinAPI function, building or reading a struct, or passing a callback to native code. TRIGGER when: user says "DllCall", "call a Windows API", "Buffer", "NumPut/NumGet", "struct", "pointer", "CallbackCreate", "StrGet/StrPut", "marshal", "user32/kernel32". Examples: "call GetCursorPos", "build a RECT struct", "pass a callback to EnumWindows"

Search AHK v2 documentation for a function, method, directive, or concept. Returns relevant documentation excerpts with syntax and examples. TRIGGER when: user says "docs for", "how does X work in AHK", "AHK docs", "look up", "what is the syntax for", "documentation".

Load AHK v2 error diagnosis, debugging, and fix knowledge. Use when diagnosing errors, fixing broken scripts, or debugging unexpected behavior. TRIGGER when: user mentions error, crash, broken, not working, debug, exception, TypeError, UnsetError, ValueError, OSError, syntax error, runtime error, fix, problem, issue, thrown, try, catch, troubleshoot, bug, fail, undefined, wrong output, unexpected behavior. Examples: "fix this error", "script crashes on startup", "UnsetError on line 42", "debug this"

Load AHK v2 GUI knowledge for window creation, layout, controls, events, and dark mode. Use when creating or modifying GUIs, positioning controls, handling events, or applying themes. TRIGGER when: user mentions gui, window, dialog, control, layout, button, ListView, ComboBox, dark mode, OnEvent, OnSize, positioning, resize, menu, toolbar, tab, checkbox, radio, edit, text, statusbar, form, modal, popup, theme, style, color. Examples: "create a GUI", "add a button", "fix overlapping controls", "dark mode window", "resize handler"

Load AHK v2 OOP knowledge for class design, objects, arrays, and dynamic properties. Use when working with classes, inheritance, objects, arrays, Map, prototypes, or property descriptors. TRIGGER when: user mentions class, object, inheritance, extends, super, property, DefineProp, Array, Map, prototype, __New, __Delete, static, nested class, factory, collection, filter, reduce, sort, bind, callback, descriptor. Examples: "create a class", "add inheritance", "use Map for storage", "filter an array", "define a property getter"

Load comprehensive AHK v2 reference covering all domains — OOP, GUI, text, errors, data structures. Use as a general-purpose fallback when no specific domain skill applies, or when the task spans multiple areas. TRIGGER when: user mentions #Include, library, import, reference, comprehensive, overview, data structures, Map, key-value, dictionary, storage, settings, configuration, how does AHK, general AHK question, jsdoc, document, annotate, add docs, docstring, comment style, api docs. Examples: "how do #Includes work", "AHK v2 overview", "data structure for settings", "general reference", "add JSDoc", "document this class", "annotate the API"

Load AHK v2 text processing, string operations, regex, and escape knowledge. Use when working with strings, regex, escaping, concatenation, or text manipulation. TRIGGER when: user mentions string, regex, escape, backtick, quote, concatenation, RegExMatch, RegExReplace, StrReplace, SubStr, InStr, StrLen, StrLower, StrUpper, Format, pattern, match, replace, split, join, text, parse, CSV, TSV, newline. Examples: "regex to match emails", "escape quotes in string", "split text by newline", "string concatenation"

AHK v2 version & portability guidance — what runs on stock v2.0 vs v2.1-alpha vs the +Console fork, and how to write code that works on the build the user actually has. Use when choosing a #Requires floor, checking whether Print / Eval / typed Struct / (a?)() are available, detecting the interpreter at runtime, or making a script portable. TRIGGER when: user says "which version", "will this run on", "portable", "works on stock AHK", "is Print/Eval available", "what does the fork add", "#Requires version", "target v2.0", "detect the build", "A_AhkVersion". Examples: "will this run without my fork", "make this portable", "is typed Struct in v2.0"

Windows messages, subclassing, owner-draw, DWM frame styling, and WinRT for AHK v2. Use when intercepting window messages, subclassing a control, applying a dark title bar / Mica / Acrylic / rounded corners, or calling a Windows Runtime (WinRT) API. TRIGGER when: user says "OnMessage", "SendMessage/PostMessage", "subclass", "WM_", "owner-draw", "dark title bar", "Mica/Acrylic", "rounded corners", "WinRT", "clipboard history". Examples: "intercept WM_NOTIFY", "dark title bar on my GUI", "Mica backdrop", "use a WinRT API"

Audit AHK v2 code for silent failures and inadequate error handling. Hunts for empty catch blocks, swallowed errors, broad bare-catches that hide unrelated failures, and fallbacks that mask problems from the user. TRIGGER when: user says "audit errors", "check error handling", "find silent failures", "review error handling", "scan for swallowed errors", "empty catch blocks", "/ahk-audit-errors".

Convert AHK v1 code to AHK v2. Applies comprehensive v1-to-v2 conversion rules including command syntax, expression changes, GUI rewrites, and object model updates. TRIGGER when: user says "convert to v2", "v1 to v2", "upgrade script", "migrate from v1", "convert this old script", "make this v2".

Show a compact debug state dashboard during an active debugging session. Queries MCP resources for connection status, breakpoints, variables, and call stack. TRIGGER when: user says "debug dashboard", "show debug state", "debug status", "what's the debugger showing", "debug overview".

Live AHK v2 REPL backed by the fork's native Eval() BIF. Execute AHK expressions and get immediate results without writing a multi-line script. Use when testing snippets, checking syntax, or evaluating expressions without creating files. TRIGGER when: user says "eval", "try this expression", "what does X return", "test this snippet", "run this AHK code", "check if this works". Examples: "/ahk-eval StrSplit('a,b,c', ',').Length" returns "3"

Show your most common AHK v2 mistakes from the error log. Reads .claude/error-log.jsonl and reports recurring patterns with prevention tips. TRIGGER when: user says "my mistakes", "common errors", "what do I keep getting wrong", "error patterns", "recurring bugs".

Modernize outdated AHK v2 patterns in a script. Finds and upgrades old syntax like new ClassName(), ComObjCreate(), missing #Requires, and bare = assignments. TRIGGER when: user says "modernize", "upgrade patterns", "update old syntax", "clean up v2 code", "fix old patterns", "convert to modern v2".

Scaffold a new AHK v2 class with proper structure, constructor, destructor, and property stubs. TRIGGER when: user says "new class", "create a class", "scaffold class", "class template", "start a new class".

Run an AHK v2 script against the alpha.30+Console fork and capture its output. Executes headlessly with stdout/stderr capture and exit-code reporting. TRIGGER when: user says "run this", "execute", "test run", "try running", "launch script", "check output".