amazon-taxes

AI skill that processes Amazon sales tax reports and generates per-state filing summaries.

Why

Amazon sellers registered in multiple states must file returns even when Amazon collects all tax as a marketplace facilitator. This skill processes Amazon's Combined Sales Tax Report to generate per-state summaries showing gross sales, marketplace-collected tax, and tax owed — ready for filing on state portals or handing to an accountant.

Install

npx skills add julioccorderoc/amazon-taxes -g -y

This copies the skill into ~/.agents/skills/amazon-taxes/ and symlinks it into your agent's skill directory (e.g., ~/.claude/skills/ for Claude Code). Works with any agent that supports the skills ecosystem.

Options:

npx skills add julioccorderoc/amazon-taxes -g           # global install
npx skills add julioccorderoc/amazon-taxes --agent cursor  # specific agent only

Usage

Once installed, prompt your AI agent with natural language:

Import the file 2026Jan1-2026Apr1_CustomCombinedTax.csv for Q1-2026 and generate a filing report for WA, NC, GA, OH, and MN.

The skill handles CSV parsing, normalization, per-state aggregation, and output formatting automatically.

Capabilities

• Manual CSV import from Seller Central (Combined Sales Tax Report)
• Per-state filing summaries with gross sales, taxable sales, and tax collected
• Promotional discount deductions from taxable basis
• Multiple period formats: quarterly, monthly, semi-annual, annual
• Table and CSV output

Not yet supported

• SP-API automated fetching — requires Amazon API credentials that aren't configured. Reports must be downloaded manually from Seller Central (~2 minutes per quarter).

CLI

Requires Python 3.11+. With uv:

uv sync
uv run amazon-taxes import report.csv --period Q1-2026
uv run amazon-taxes report --states WA,NC --period Q1-2026
uv run pytest

Without uv (any environment with Python 3.11+ already installed):

python -m venv .venv && . .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
amazon-taxes import report.csv --period Q1-2026
amazon-taxes report --states WA,NC --period Q1-2026

The .venv/ directory is platform-specific and gitignored — never commit it. A fresh clone builds its own on any Python 3.11+ host.

Docs

• Product Requirements
• Implementation Roadmap
• Research (TaxJar analysis, SP-API, tax complexity)