Tools

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

20 capabilities20 tool

Automated heuristic

Tool docs quality: F — 20 tools graded

Average 30/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: 0
Grade C: 0
Grade D: 1
Grade F: 19

How grades work

ack_decisiontool
mcp:decide
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.
add_checklist_itemtool
jobs:write
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 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: 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.
assign_jobtool
mcp:assign
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 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: 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.
attach_evidencetool
mcp:evidence
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 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: 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.
create_jobtool
jobs:write
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 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: 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.
create_tagtool
tags:write
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: 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.
get_briefingtool
jobs:read
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.
list_checklisttool
jobs:read
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.
list_jobstool
jobs:read
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.
list_memberstool
members:read
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.
list_stagestool
stages:read
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.
list_tagstool
tags:read
Description quality grade D, 50/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 1 word. 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: 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.
list_templatestool
jobs:read
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.
move_jobtool
jobs:write
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 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: 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.
report_progresstool
mcp:claim
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.
request_human_decisiontool
mcp:decide
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.
resolve_decisiontool
mcp:resolvedecision
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.
set_checklist_itemtool
jobs:write
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 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: 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.
update_jobtool
jobs:write
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 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: 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.
update_stagetool
stages:write
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 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: 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.