Docs

Auto-Match Rules

Auto-match decides which skills the agent pulls in automatically for a given request. You tune it in Settings → Skills → Rules.

How matching works

Each skill has one or more rules. When you send a prompt, Agentastic scores every rule against your current situation and activates the skills whose best rule clears a threshold. Signals a rule can match on:

  • App — the frontmost app's name or bundle ID (e.g. Gmail, com.tinyspeck.slackmacgap)
  • Website — the URL host or path patterns of your active tab (e.g. amazon.com, /dp/)
  • Prompt keywords — words that appear in your prompt. Any (at least one matches) or all (every one must match).
  • Selected-text keywords — words in the text you've selected.
  • Exclude keywords — words that prevent a match.

More specific signals score higher — a URL-host match counts for more than a single prompt keyword — and each rule can apply a priority boost to nudge its score.

The controls

Per skill, you set:

  • Minimum score — how strong a match must be before the skill activates. Raise it to make a skill fire less often; lower it to fire more eagerly.
  • Max matches per turn — caps how many of a skill's rules contribute in a single request.
  • Enabled — turn the whole skill's auto-matching on or off.

Per rule, you edit the apps, hosts, patterns, and keywords above, and enable/disable individual rules.

Tuning tips

  • Skill firing too often? Raise its minimum score, tighten keywords (use all instead of any), or add exclude keywords.
  • Skill not firing when it should? Lower the minimum score, add the app or website you use it in, or add more any keywords.
  • Two skills competing? Use the priority boost and more specific app/host rules to disambiguate.

After editing, save — changes take effect on your next prompt.

Manual override

You can always attach a skill explicitly with /skill:name regardless of its rules, or rely purely on manual activation by disabling a skill's auto-matching.

Related