absence-check
Installation
SKILL.md
Absence Check
When to use
Use before reporting "none", "zero", "does not exist", "failed", or "removed" from an empty result, old status report, unfinished job, or green test summary. Apply only to the claim being made and the sources the task permits you to read.
Steps
- State the exact claim and identify the source that could prove or disprove it. Ask whether your check could have shown the opposite result. If it could not, choose a check that can.
- Validate the query. Run a control query for a known item using the same tool, credentials, root, and filters. Preserve errors and exit codes. If the control misses or the tool errors, report the query as unverified and diagnose that condition before interpreting the empty result.
- Establish coverage. Name the searched source, roots, filters, included record states, snapshot time, and relevant exclusions. Resolve symlinked search roots when the tool does not follow them. Search plausible synonyms, spellings, or identifiers when the source's vocabulary varies. If an authorized semantic search is available, use it when literal terms cannot cover the claim.
- Establish freshness. Read the current authoritative artifact where available. If you only have a snapshot, describe its timestamp and limits. A saved report or ticket records a prior observation; use it to locate evidence rather than treating it as present state.
- Establish completion. Read the tool's terminal status or process exit code. For asynchronous work, poll to a stated limit appropriate to the tool and task. If the done signal has not arrived at that limit, report "pending" or "not visible after ". Diagnose a terminal error before naming its cause.
- Inspect actual coverage in test results. Report executed, passed, failed, and skipped checks separately. If relevant checks skipped or have no execution evidence, mark their coverage unverified, even when a summary says PASS.
- Write the narrowest supported conclusion. If coverage is partial, say "not found in ". If a complete, current source and valid query support an absence claim, qualify it with that source and observation time. If a consequential close or removal decision depends on the conclusion and the first check could not show the opposite, obtain a different check that can before recommending the action.
Output shape
Return a short answer and this evidence when it affects the conclusion: