The Trigger Macro by Name action displays a Spotlight-like window, where you trigger execution of a Macro by searching for it, and then selecting it.
Like the Mac Spotlight, it will search all of your active, enabled Macros whose name or contents contain what you type. It is a character search, so it will also find Macro names and words that contain what you type.
The initial search can (v9.0+) include tokens.
If you wish to open Keyboard Maestro directly to the selected macro rather than triggering it, use ⌥Return or ⌥+click.
If you would like to further restrict, or filter, the search, you can use qualifiers, or prefixes, to what you type, using these Search Strings.
would filter the list of Macros to those whose:
For the complete list of available filters, see Search Strings
You can pass parameters (v8+) to the macro via the %TriggerValue% token by adding
// and then the parameter to your search string. The
// and anything after that will be ignored in the search.