VAT Compliance Optimization: Agent Skill for Tax-Smart Dev

Where this fits

You're building an agent that reviews a client's monthly tax filings. The client is a mixed-services company with both 9% and 6% revenue streams, and you need to check if their input VAT deductions are complete and whether they qualify for a retention refund. This skill gives your agent the legal framework, rate tables, and deduction rules to turn raw invoice data into actionable compliance advice—no manual tax research required.

Why agents benefit

• Apply statutory logic automatically: The skill encodes the VAT Provisional Regulations and implementation rules, so your agent can determine correct tax rates for mixed sales and concurrent operations without hallucinating.
• Compute retention refund eligibility: It includes the 2019 Notice 20 conditions (6-month incremental threshold, 60%/100% refund ratio) and can calculate whether a client qualifies.
• Detect deduction chain gaps: Using grep and bash, the agent can scan invoice line items for disallowed inputs (e.g., used for collective welfare) and flag missing special invoices.
• Generate scenario-based recommendations: From choosing between general vs. small-scale taxpayer status to splitting mixed contracts, the agent outputs concrete optimization paths.
• Stay policy-aware: The webfetch tool lets the agent pull the latest circulars, keeping advice current beyond the embedded 2018–2022 references.

Practical scenarios

Scenario 1: High retention credit planning

A manufacturing client has 2.1M RMB in retention credits. The agent evaluates the 6-month incremental pattern, checks tax credit rating (A/B), and computes the refundable amount under the 60% rule—then suggests timing the application to maximize cash flow.

Scenario 2: Mixed sales rate splitting

A software company sells licenses (6%) bundled with hardware (13%). The agent parses the contract, applies the mixed sales rule from the Implementation Rules, and recommends splitting invoices to avoid overpaying VAT on the entire bundle.

Scenario 3: Cross-border service zero-rating

An export consultancy provides services to an overseas client. The agent verifies the zero-rating conditions under the cross-border rules, checks documentation requirements, and flags whether the input VAT on related domestic purchases can be fully deducted.

Add it to your agent workflow

Install the skill directly into your agent's skill directory:

npx skills add guoliang1114-boop/AriaAI --skill vat-compliance-optimization

Then invoke it in your agent's reasoning loop. For example, after reading a client's VAT return and invoice ledger:

> Use vat-compliance-optimization to analyze the input/output VAT for Q3.
> Output: tax burden ratio, deduction gaps, and a refund eligibility check.

The skill will use read and bash to compute metrics and return a structured optimization plan.

Compare before adopting

Before committing, compare this skill against alternatives using three signals: freshness (last updated Aug 2026, but check if it references newer circulars), domain precision (it's China-specific; won't help for EU VAT), and workflow fit (does your agent already have read/webfetch tools? If not, you'll need to add them). Also check the GitHub repo's issue tracker for reported edge cases—37 stars is modest, but the author responds to PRs.

Why it is worth tracking

This skill fills a real gap: most agent tax skills are generic or US-centric, while this one targets China's VAT regime with actionable logic. The stable status and explicit legal citations make it a solid baseline. Watch for updates that add provincial policy nuances or integration with accounting APIs. If your agent serves Chinese SMEs or cross-border e-commerce, evaluate this skill now—it could save hours of manual tax rule lookup and reduce compliance risk in your agent's output. For a living index of similar domain-specific skills, see OpenAgentSkill.