Tools

Everything poltertab exposes to your AI client: tools, resources and prompts.

28 capabilities28 tool

Automated heuristic

Tool docs quality: D — 28 tools graded

Average 46/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.

Grade A: 0
Grade B: 2
Grade C: 10
Grade D: 4
Grade F: 12

How grades work

browser_clicktool
selector (required)
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_extracttool
record, fields (required), anchor, maxtext, probe, outputfile
Description quality grade B, 80/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_extract_alltool
urltemplate, record, fields (required), key, limit, offset, startpage, maxpages, filltolerance, outputfile
Description quality grade B, 75/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_filltool
selector, value (required), submit
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_get_network_statetool
clear, outputfile
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_get_site_memorytool
hostname (or domain)
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 3 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_get_texttool
selector (required), maxtext, outputfile
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_get_titletool
—
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 0 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_get_urltool
—
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 0 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_hovertool
selector (required)
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_navigatetool
url (required)
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_save_site_memorytool
hostname (or domain), obstacle, solution
Description quality grade F, 30/100 · 5 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_scrapetool
selector, attribute, multiple, fields, maxtext, outputfile
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_screenshottool
—
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 0 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_scrolltool
direction (required), amount, selector
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_session_closetool
name (required), force
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 3 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_session_contexttool
—
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 0 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_session_createtool
name (required), url, tabId
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_session_listtool
—
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 0 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_session_switchtool
name (required)
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_set_intercept_patternstool
patterns (required)
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 2 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_smart_scrolltool
direction (required), amount
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 3 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_snapshottool
interactiveonly, maxnodes, maxdepth, outputfile
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_tab_closetool
tabId or session, force
Description quality grade F, 20/100 · 5 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_tab_listtool
all
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 1 word. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_tab_newtool
url, session, background
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 3 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_tab_switchtool
tabId or session, focus
Description quality grade F, 35/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed0/20
  Only 4 words. Say what the tool needs and what it returns.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
browser_upload_filetool
selector (required), paths (required), method ("picker" or "drop"), tabId, session
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.