hubdoc-reviewer

name	hubdoc-reviewer
description	Review all unreviewed documents in Hubdoc. Use when reviewing, processing or publishing Hubdoc receipts and bills.

Hubdoc Reviewer

Reviews all documents in the Hubdoc Review tab, one by one, and (when that is empty) the Failed tab.

Skill maintenance goal

When adding or updating instructions in this skill, all documented methods (JS selectors, click sequences, field-setting approaches) must be tested and verified to work before being committed to the skill. Never document untested code. The goal is to build bulletproof, reliable documentation so that Hubdoc automation works first time without painful trial and error.

Prerequisites

• The agent-browser skill is installed
• agent-browser connected to Chrome
• Tab open on https://app.hubdoc.com (open new one if necessary)

Do not use agent-browser wait --load networkidle — Xero never reaches networkidle; use agent-browser wait 3000 instead.

Logging in

Always use "Sign In With Xero" — never use the email/password form:

# If the login page appears, click "Sign In With Xero"
agent-browser snapshot -i  # find the Sign In With Xero link
agent-browser click @eN
agent-browser wait 3000

Click the "Sign In With Xero" button yourself — do not ask the user to. When already logged into Xero, this is SSO/OAuth to an already-authorized app, NOT credential entry, so it is not a prohibited action. A stale ?timeout=true URL does NOT mean the session carried through — the button must actually be clicked. Being too timid here just makes the user do a click they delegated to you.

Finding and interacting with page elements

Always use snapshot -i -C (not just -i) when looking for interactive elements. The -C flag includes cursor-interactive elements (divs with onclick, cursor:pointer) which many Hubdoc buttons and controls rely on. Omitting -C will cause buttons to be invisible to the snapshot.

Choose the approach based on the nature of the element you're looking for:

• Element with a known ID (see references/fields.md) → JS eval to confirm which ref corresponds to that ID. Use JS only to identify, not to set values.
• Labelled interactive element (button, link, named input) → snapshot -i -C; use the ref directly.
• Element identified by surrounding label text (e.g. an unlabelled combobox next to an "Account Code" label) → snapshot (no -i) to get the full accessibility tree including non-interactive text, then find the label and identify the adjacent ref.
• Nothing else works → screenshot as a last resort for visual confirmation.

Taking into account some exceptions listed in the references below, as a general rule once the correct ref is identified, first try to interact via

agent-browser select/fill/click @eN

and similar, and only move onto other techniques like eval with JS if that fails.

Xero vs Xero Files

Hubdoc has a Xero destination section and a separate Xero Files section. They are not interchangeable.

• For accounting publish configuration, always use the Xero section.
• Never use the Xero Files section when configuring or publishing a document for accounting.
• If publish fields are not visible, expand the Xero section itself, not the Xero Files section.
• When inspecting the DOM, verify you are using xero-edit-integration or push-to-xero-* fields, not xerofiles-edit-integration or push-to-xerofiles-* fields.
• Scroll the Xero section into view before interacting with it. Its controls (Status, Account Code, Contact, Publish button) sit below the fold on most viewports, and clicks on off-screen refs can miss or hit the wrong element. Use agent-browser scrollintoview @ref on the Xero section header (or any ref inside it) before snapshotting and acting:

  agent-browser snapshot -i -C            # find the Xero section ref
  agent-browser scrollintoview @eN        # scroll Xero section into view
  agent-browser snapshot -i -C            # re-snapshot for in-view refs
  

  Do NOT use eval with scrollIntoView() — prefer the native agent-browser scrollintoview command (same convention as xero-browser skill).

Account code guidance

Before guessing an account code, consult the local accounting guidance for your workspace — typically a file under your project's notes directory, an environment variable like $ACCOUNTING_NOTES, or a project-level CLAUDE.md / AGENTS.md entry. Account-code conventions vary per Xero organisation, so never rely on memorised codes from another tenant.

References

Topic	File
Field IDs and how to set values via JS	references/fields.md
Uploading PDFs / images	references/uploading.md
Downloading and reading Hubdoc PDFs	references/downloading.md
Searching for documents	references/searching.md
End-to-end review-tab process (per-document workflow)	references/review-process.md
Duplicate-document detection, decision, trashing, drawer close	references/duplicates.md
Failed-tab processing (validation errors and re-publishing)	references/failed-tab.md

Load the relevant reference for the specific subtask. The review-process reference is the main per-document workflow and is needed for any document review session; the others are loaded on demand.