tables-error-sweep

Installation
SKILL.md

Error sweep

Use when: "what's erroring in {table}?", "show failed rows", "is {action} failing?" — a table-level question with no specific record in hand. Goal: find the errored rows, read their messages, and report grouped by root cause, not row by row.

Only action columns can be in error. basic and source columns don't error (a formula-backed basic can, rarely), so the sweep is about action columns.

1. Understand the table first

Before sweeping, learn what can error.

  1. Resolve the table as in the tables entry-point skill ("Finding a table").
  2. clay tables columns get <tableId> (shape in the command's --help). Build the picture:
    • Which columns are type: "action" — these are the ones that fail. Keep a f_id → name map for readable reporting.
    • For each action column, note authAccountId (auth-related failures), conditionalRunFormulaText (a gate — a skipped action usually shows as empty, not a failure), and inputsBinding (what feeds it — needed if a failure turns out to be a bad/missing input).
  3. If the table has no action columns, errors are unlikely — say so, and confirm with a one-page scan (step 3) before concluding.

2. Settle the scope: one column or general

Installs
1
GitHub Stars
140
First Seen
Aug 15, 2026