How to get more accurate results from Mateo

A Rebuild Package is only as good as the evidence behind it. A few deliberate choices raise the quality of what your agent builds.

Pick the right page

Capture the page you actually want to rebuild, and make sure it carries the design. A homepage or a core product page usually exposes the most sections, components and motion. Sparse pages (error pages, bare sign-in screens) give Mateo little to measure.

Capture public pages only. Mateo doesn't capture anything behind a login or paywall, and sites that block automated browsers may fail or come back with Low coverage. Keep the tab open while the capture runs.

Read coverage before you build

Open Capture details on the result page. Coverage shows how much rebuild evidence the capture holds for each dimension: layout, typography, color and effects, assets, motion, responsive, interactions and page completeness. Overall coverage is High, Medium or Low. It measures completeness, not quality.

• High: strong evidence for a faithful first build.
• Medium: a solid first build with a few gaps to iterate on.
• Low: limited evidence. The build leans on screenshots and iteration.

Read the known gaps

Known gaps list what Mateo could not verify. They are in the package so your agent asks you instead of guessing. Skim them before you start: if a gap covers something you care about (a key animation, a missing asset), you will know to check it first.

Recapture when coverage is Low

Low coverage often comes from the page itself: content that loads late, a site that resists automated browsers, or a page that shows little at first load. Try again, or capture a richer page on the same site. A completed capture uses one credit; a capture that fails before Mateo starts building the package doesn't count.

Answer your agent's questions

The agent prompt tells your coding agent to ask about anything marked (inferred) or listed under Unknowns in REBUILD.md. Answer those questions. You know the site, and a one-line answer from you beats a confident guess from the agent. Then let it rerun the self-validation loop in REBUILD.md §9.

Mateo captures evidence, not a guarantee. Your agent closes the last gap with you.

More: Coverage and known gaps · Troubleshooting · How to use Mateo with Claude Code, Cursor or Codex.