eyeball

Generates Word documents where every analysis claim includes a highlighted screenshot from the source document.

38.5k|4.9k|Updated Jun 11, 2025
One-click install
npx skills add https://github.com/github/awesome-copilot --skill eyeball
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eyeball
Source: https://github.com/github/awesome-copilot/tree/main/skills/eyeball
Command: npx skills add https://github.com/github/awesome-copilot --skill eyeball

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf, pillow, python-docx, playwright, pywin32.

What problem does it solve?

Document analysis produced by AI is hard to verify because claims are not tied to visible evidence in the source material. Eyeball solves this by generating a Word document where every factual assertion is paired with an inline screenshot from the source, with the cited text highlighted in yellow so you can verify each claim with your own eyes.

Core Features & Use Cases

  • Verifiable Analysis Output: Builds a .docx report where each analysis section includes a cropped source screenshot with the supporting text highlighted.
  • Multi-Format Source Support: Works with local Word documents (.docx, .doc), PDFs, RTF files, and any publicly accessible web URL (rendered to PDF via Playwright).
  • Precise Anchor-Based Highlighting: Searches verbatim phrases on target pages using PyMuPDF, dynamically sizing screenshots to cover all cited passages, including multi-page stitching.
  • Use Case: Ask Copilot to analyze a vendor contract's limitation of liability clause. Eyeball produces a Word doc on your Desktop where each observation about Section 12 is followed by a screenshot of the exact contract language, highlighted, so legal review takes minutes instead of hours.

Quick Start

Ask Copilot to use eyeball to analyze a specific document or URL and produce a Word report with highlighted source screenshots on your Desktop.

Frequently Asked Questions about eyeball

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify AI-generated document analysis against the source?

Use Eyeball to generate a Word document where each analysis claim includes an inline screenshot from the source with the cited text highlighted in yellow. You can then visually confirm every assertion against the original material without manually searching the document.

How to highlight cited text in PDF screenshots with Python?

Use PyMuPDF's page.search_for() to locate verbatim phrases, render the surrounding region with get_pixmap, and draw semi-transparent yellow rectangles over matches with Pillow. Eyeball automates this and stitches multi-page results vertically.

What file formats does Eyeball support for document analysis?

Eyeball supports local Word documents (.docx, .doc), PDFs, and RTF files, plus any publicly accessible web URL. Non-PDF files are converted via Microsoft Word or LibreOffice, and web pages are rendered to PDF using Playwright with Chromium.

Why does Eyeball report that a screenshot is not available?

This happens when the anchor phrases are not verbatim matches found on the target page. Anchors must be exact text from the source, not paraphrases or generic topic labels. Re-run extract-text, pick specific uncommon phrases, and rebuild.

What dependencies are required to run Eyeball?

Core dependencies are pymupdf, pillow, and python-docx. Web URL support additionally requires playwright with Chromium installed, and Windows Word automation requires pywin32. Run the setup-check command to verify your environment.