tax-compare

Compare two tax return PDFs against a canonical 1040 field mapping.

12|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Fangyi-Chen/SuperTaxAgent --skill tax-compare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tax-compare
Source: https://github.com/Fangyi-Chen/SuperTaxAgent/tree/main/skills/tax-compare
Command: npx skills add https://github.com/Fangyi-Chen/SuperTaxAgent --skill tax-compare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diff two tax return PDFs (our output vs a reference) to identify discrepancies and ensure accuracy.

Core Features & Use Cases

  • PDF comparison: compare field values against a canonical 1040 mapping to surface mismatches.
  • Traceable outputs: saves a structured diff to data/comparison-{year}.json for audits and community contributions.
  • Use Case: verify that your tax preparation output matches a trusted reference like TurboTax before filing.

Quick Start

Run a comparison by providing your generated PDF and a reference PDF to the skill.

Frequently Asked Questions about tax-compare

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

FAQPage Schema
How do I compare two tax return PDFs to find line-item discrepancies?

Comparing two tax return PDFs involves diffing your generated output against a reference filing using a canonical 1040 field mapping to identify line-item mismatches. The tool reads both PDFs and highlights any discrepancies between field values.

Can I validate my generated Form 1040 against a TurboTax export?

You can validate your generated Form 1040 against a TurboTax export by providing both PDFs for comparison. The skill checks line-item values against a canonical 1040 field mapping to surface any mismatches.

Do I need Python and pypdf to audit tax return PDFs?

Yes, you need Python 3 and the pypdf library installed to audit tax return PDFs. These dependencies are required to read the PDF files and extract the field values for the comparison process.

How does tax form PDF comparison handle audit traceability?

Tax form PDF comparison handles audit traceability by saving a structured diff of all identified discrepancies to a JSON file. This provides a permanent record of the comparison results for later review and community contributions.

What is the best way to verify tax preparation accuracy before filing?

The best way to verify tax preparation accuracy is to diff your output PDF against a trusted reference filing. This validates your calculated line-items against a canonical 1040 mapping to ensure correctness before you file.

Why does tax form comparison require a canonical 1040 field mapping?

Tax form comparison requires a canonical 1040 field mapping to accurately locate and validate specific line-item values across both documents. This mapping ensures the tool reads the correct fields for a reliable discrepancy check.