Skip to content
Get packs

Guide · Agent skill

How to use the Eyeball document analysis agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

Eyeball is an agent skill that makes Copilot analyze a document and return a Word file where each point is backed by a screenshot of the original text, with the supporting phrase highlighted in yellow. This guide is for people who have never used agent skills and want to check AI-written summaries against the source. By the end you will know what the skill does, how to install it, how to ask for it, and what it needs to run.

Eyeball Document Analysisgithub/awesome-copilot · MIT

Quick start

  1. 1Download and unzip. Download the ZIP from the skill page and unzip the eyeball folder into ~/.claude/skills/ or a project's .claude/skills/ folder.
  2. 2Install dependencies. Install Python 3, the pymupdf, pillow, python-docx and playwright packages, and the Playwright Chromium browser.
  3. 3Run the setup check. Run the eyeball.py setup-check command to confirm everything is available.
  4. 4Ask for the analysis. Say something like "use eyeball on this document" and include the file path or URL.
  5. 5Let the agent read the source. The agent extracts the full text first so its section and page references match the document.
  6. 6Open the Word file. Find the .docx file on your Desktop and check each highlighted screenshot against the claim beside it.

What the Eyeball skill makes the agent do

An agent skill is a folder of instructions and optional scripts that an AI agent loads when your request matches it. Eyeball tells the agent to read the source, write an analysis with exact section and page references, and build a Word document on your Desktop. Every factual claim in that document is paired with an inline screenshot of the source with the cited phrase highlighted.

It works on Word (.docx, .doc), PDF (.pdf) and RTF files, and on any publicly accessible web page.

  • Output: a .docx file saved to your Desktop
  • Each point has a screenshot of the original text with the supporting phrase highlighted in yellow
  • Screenshots are sized to cover all the phrases you cite in that section

Install the Eyeball skill

Download the ZIP from the skill page and unzip it. You have two options depending on how you use your agent.

For Claude Code or Copilot CLI, unzip the folder into ~/.claude/skills/ for all your projects, or into a project's .claude/skills/ folder for one project only. In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project folder
  • Claude apps: Settings → Capabilities → Skills

Install the dependencies

The skill runs a local Python script, so Python 3 and several packages must be available. Check the setup first with the skill's own command, then install anything missing.

On Windows, the skill also uses pywin32 for Word automation. The skill looks for Copilot CLI plugins in ~/.copilot/installed-plugins, so that is where a plugin install is expected.

  • Python 3
  • pymupdf, pillow, python-docx, playwright
  • Playwright Chromium browser
  • pywin32 on Windows only
python3 <path-to>/eyeball.py setup-check pip3 install pymupdf pillow python-docx playwright python3 -m playwright install chromium pip install pywin32

Trigger the skill with a natural request

You do not need special syntax. Phrases such as "use eyeball", "run eyeball on this" or "eyeball this document" activate it. Give the agent the file path or the URL in the same message.

When the skill activates, the agent confirms that Eyeball is active and explains that it will produce a Word doc with inline source screenshots.

  • "Use eyeball on ~/Documents/vendor-contract.pdf"
  • "Eyeball this document: https://example.com/terms"
  • "Run eyeball on the attached policy and tell me what it says about refunds"

Understand what the agent does with your document

The workflow has five steps. First the agent extracts and reads the full text of the source, so it works from actual section numbers and page numbers rather than assumptions. Then it writes each analysis point with a section reference and page reference, selects verbatim phrases to highlight, builds the document, and saves it to your Desktop.

Anchors are the phrases that get highlighted. Good anchors are specific and uncommon, such as a numbered section heading plus a distinctive term. Generic labels that appear throughout a document are a poor choice because they highlight the wrong places.

  • Step 1: read the source text
  • Step 2: write analysis with exact section and page citations
  • Step 3: select verbatim, specific anchors
  • Step 4: build the analysis document
  • Step 5: save to Desktop and report the filename

Check the output and handle common problems

Open the Word file and compare each highlighted screenshot with the analysis beside it. If the screenshot does not show the claim, the analysis or the anchor is wrong. The skill itself notes when a search term is not found in the document, which usually means the anchor was not verbatim.

For web pages, the page is rendered to PDF first, so page numbers can differ from what you see in a browser. Use the extracted text to confirm page numbers.

  • If the output says a term was not found, the anchor was probably not word-for-word
  • Web page page numbers may not match your browser
  • Scanned or image-only documents may not highlight correctly (likely limitation, not stated explicitly in the skill files)

What people use it for

  • Reviewing a contract, terms of service or policy and checking what it actually says
  • Producing page-referenced summaries of reports for students or researchers
  • Auditing an AI-written summary against the original source document
  • Checking claims in a public web page against the rendered text

Frequently asked questions

How do I install the Eyeball agent skill?

Download the ZIP from the skill page and unzip it into ~/.claude/skills/ for all projects, or into a project's .claude/skills/ folder. In the Claude apps you can upload it under Settings → Capabilities → Skills.

What do I need to run Eyeball?

You need Python 3, the pymupdf, pillow, python-docx and playwright packages, and the Playwright Chromium browser installed with python3 -m playwright install chromium. On Windows, pywin32 is also needed for Word automation.

Is Eyeball free?

The skill is published under the MIT licence. The source material does not mention pricing, so check the repository and the licence file for the terms.

Does Eyeball send my documents to the internet?

It reads local files and fetches public web pages you point it at, and it runs a local Python script. Because it uses the network, avoid sending confidential documents through web pages or tools you have not reviewed.

What file types does Eyeball support?

It supports Word documents (.docx and .doc), PDFs (.pdf), RTF files, and any publicly accessible web page.

Why does the output say a search term was not found?

The anchor phrase probably did not match the source word for word. Adjust the anchor to use the exact text from the document and build the file again.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Eyeball suits people who need to verify what a contract, policy, report or web page actually says, and who are willing to install Python packages and wait for a multi-step build. If you only need a quick summary, or you are working with confidential files you cannot send through the tools involved, choose a simpler summarising approach instead.

Download the skill