DANG-ai/SKILLER / gaia/skills/ours_x4p3
gaia-compact-evidence-router-skill
VerifiedCompact attachment-first router for GAIA-style tasks under a static ReAct loop with narrow evidence gathering, lightweight derivation, and strict answer-shape control.
Use Contract
- Start by reading
task.json; if the workspace view is unclear, uselist_dironce and then continue locally. - Treat task wording, local attachments, and extracted local text as the first evidence layer.
- Browser automation is unavailable. For public web evidence, use
web_searchto locate,fetch_urlto retrieve, andhtml_extractto isolate usable text. - Use web only when the task truly needs external public facts, historical page states, source verification, or cited public records that local files do not contain.
- When media exists, stay local first:
image_metadata,ocr_image,image_qa, oraudio_transcribe. - Use
run_pythonfor arithmetic, parsing, decoding, filtering, sorting, joins, unit conversion, coordinate math, and answer-shape checks. - Each tool call should do one decisive job: locate a source, extract a field, compute a value, or verify final form.
- Prompt Contract Compiler: before routing or answering, bind four scratch fields—scope (entity/source/snapshot/inclusions/exclusions), evidence (minimal fields to extract), op (lookup/filter/compare/count/sort/diff/transform), and surface (required answer form). Use scope to lock the source and boundary, evidence plus op to decide whether you need one field or a full set, history, table, or paired snapshots before computing, and surface to shape the final string. If any decisive field is unbound, the next tool call must bind it; if all four are already clear from the prompt, answer or route directly.
- Selector substep: when the prompt asks for a choice from alternatives or a value derived from such a choice—first/last/earliest/latest/min/max/least/most/furthest/closest/before/after/between/difference/change/only/not/every/excluding/adjacent/as-of/since/which one/how many of the set—bind selector = {universe, witness, emit}. Universe is the full candidate set, pair of snapshots, ordered sequence, or cross-source join being chosen from; witness is the deciding field or rule; emit is the exact token to return from the chosen item. Use universe to lock the next source and extraction to the full set needed, witness to drive the required compare/filter/count/diff compute, and emit to keep the final answer to only the requested token in the compiled surface form. If any selector field is unbound, the next tool call must gather that full universe before answering; do not answer from a single snippet or partial row. Skip this when a prompt-complete derivation or one source-locked field already fully determines the answer.
- Final output must be a non-empty
<ANSWER>...</ANSWER>and match the requested units, ordering, separators, casing, rounding, and cardinality. - Before final, compile the answer surface from four fields when relevant: value, unit or label, order, and delimiter.
Training Signals
- Gold trajectory evidence here is weak and mostly constructed. Use it as distribution pressure only: attachment-first routing is common, short derivations are common, and exact answer shape is often decisive.
- Reusable path patterns are concentrated around local tables, local text extraction from documents or archives, OCR or audio transcription, narrow public-source verification, and lightweight Python synthesis.
- Common failure guards recur: wrong scope date, wrong subset, wrong unit, wrong sort order, wrong surface form copied from a nearby field, or an answer that omits a requested sign, separator, or format.
- Default bias: pick the smallest evidence chain that can close the task inside the step budget.
Route Table
| Signal | Primary route | Recommended tools | Stop when |
|---|---|---|---|
| Spreadsheet, roster, workbook, matrix, inventory | parse then normalize | read_table, run_python | the target rows and requested field or aggregate are isolated |
| PDF, text file, rich document, archive, citation bundle | expand then extract | extract_archive, extract_pdf_text, read_file, parse_docx, parse_pptx, run_python | the decisive passage or table is in local text |
| Image, scan, screenshot, board, label, diagram, music sheet | observe then structure | image_metadata, ocr_image, image_qa, run_python | visible content becomes discrete facts, text, counts, or positions |
| Audio, spoken instructions, narrated clue | transcribe then normalize | audio_transcribe, run_python | the relevant spoken tokens or numbers are recovered cleanly |
| Pure logic, arithmetic, decoding, geometry, comparison, ordering | derive locally | run_python, read_file, read_json_file | the exact output value or set is computed from available facts |
| Public page, official record, archive snapshot, cited article | narrow lookup then verify | web_search, fetch_url, html_extract, run_python | a source-locked passage covers the exact entity, date, and scope |
Phase: INIT
First action: read task.json. Route immediately from the question plus attachment suffixes to the shortest decisive local path.
- Route selection: choose local extraction if any attachment or embedded data appears; choose direct derivation if the prompt itself contains all facts; choose web fallback only when external public evidence is explicitly required.
- Recommended tools:
read_json_file, thenlist_dironly if needed. - Stop condition: you know the answer shape, the likely evidence location, and the next single decisive tool call.
- Failure guard: do not begin with
web_searchbefore confirming whether local files already contain the target evidence. - Final: if the question already provides enough information and format is explicit, answer immediately. Next: [LOCAL_LOCK]
Phase: LOCAL_LOCK
Classify all local materials before branching deeper.
- Route selection: use when attachments, archives, or local reference files are present; map each item to table, text, archive, image, audio, or mixed media.
- Recommended tools:
list_dir,read_json_file,read_file,image_metadata,extract_archive. - Stop condition: each relevant local artifact has a concrete extraction path and irrelevant files are ignored.
- Failure guard: filenames can mislead; rely on actual suffix, visible structure, and extracted contents rather than assumptions.
- Final: if a local artifact already exposes the exact requested field or string, answer immediately. Next: [TEXT_TABLE_PATH]
Phase: TEXT_TABLE_PATH
Turn local structured material into queryable facts.
- Route selection: use for spreadsheets, PDFs, docx, pptx, txt, extracted archives, rosters, qualifications, inventories, captions, and reference lists.
- Recommended tools:
read_table,extract_pdf_text,parse_docx,parse_pptx,read_file,extract_archive,run_python. - Stop condition: the target subset, cited passage, row group, or candidate field list is extracted into clean text or rows.
- Failure guard: watch header shifts, merged cells, duplicate labels, row-order traps, and requests that demand the source surface form exactly as written.
- Final: if the extracted rows or passage directly answer the question and the requested presentation is clear, answer immediately. Next: [MEDIA_PATH]
Phase: MEDIA_PATH
Convert local media into discrete evidence without leaving the workspace.
- Route selection: use when the task depends on visible text, object identity, board state, layout, note letters, labels, or spoken content.
- Recommended tools:
image_metadata,ocr_image,image_qa,audio_transcribe,run_python. - Stop condition: the media yields stable tokens, numbers, entities, positions, or transcript snippets sufficient for a direct answer or a short derivation.
- Failure guard: separate observation from inference; if OCR and image or audio interpretation disagree on a decisive token, spend one step resolving the conflict locally.
- Final: if the recovered media facts already match the requested answer form, answer immediately. Next: [WEB_VERIFY]
Phase: WEB_VERIFY
Use narrow public-source lookup only when the task needs evidence outside the workspace.
- Route selection: use for public facts, official databases, historical page states, cited papers, public logs, external source chains, or verification of a locally identified entity.
- Recommended tools:
web_search,fetch_url,html_extract,run_python. - Stop condition: one or two retrieved passages pin down the exact entity, date, edition, revision, or scope required by the prompt.
- Failure guard: search with tight anchors from the question, including date or source type when available. If results are noisy, reformulate once with narrower anchors and keep only source-supported claims.
- Final: if a retrieved passage cleanly supplies the answer in the requested scope and form, answer immediately. Next: [DERIVE_CHECK]
Phase: DERIVE_CHECK
Compute, compare, intersect, and format exactly.
- Route selection: use when the answer requires arithmetic, filtering, chronology, set operations, sorting, ratio comparison, route counting, decoding, unit conversion, or answer-shape normalization.
- Recommended tools:
run_pythonplus the extractor that produced raw facts. - Stop condition: the requested value, string, or ordered list is reproduced from extracted evidence and survives a cheap consistency check.
- Failure guard: verify variable identity, endpoint inclusion, threshold direction, unit scale, rounding precision, alphabetical or source order, separator choice, and any requirement to keep or remove articles, punctuation, or signs.
- Answer-shape compiler: for transformed outputs, produce the value in scratch text first, then rewrite only the surface form to match prompt constraints.
- Final: if the computed result already matches the required surface form, answer immediately. Next: []
Answer Guard
- You may answer from any phase once the evidence chain supports the exact requested form.
- Keep the final payload minimal: only the requested number, string, list, date, or phrase inside
<ANSWER>...</ANSWER>. - If the prompt asks for a bare answer, omit explanations, source names, units, and labels unless they are part of the requested surface.
- Preserve source spelling and casing when asked for text as written; normalize only when the prompt explicitly asks for transformed case, ordering, singularization, or punctuation removal.
- For numeric answers, confirm unit, sign, decimal places, thousands separators, rounding rule, and whether the task wants a bare number or a labeled value.
- For lists, confirm item count, deduplication, ordering rule, and separator formatting.
- For date or chronology tasks, confirm the referenced snapshot, revision, census year, publication date, or archive date before finalizing.
- If two candidate answers remain, use one more discriminating tool call; guessing burns the step budget and damages answer precision.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |