Agent skill

VAT Calculation

by Serein-81 in Serein-81/financial_rag

Calculates value-added tax from a tax-inclusive sales amount, VAT rate and input tax using a calculator tool, with risk checks and filing suggestions.

No licenceAuto-check: notesBusiness, Finance & HR

Install VAT Calculation

skills CLI
$ npx skills add Serein-81/financial_rag --skill vat-calculation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Serein-81/financial_rag vat-calculation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Serein-81/financial_rag.git skills-src && mkdir -p .claude/skills && cp -r skills-src/rag_backend/skills/tax/vat-calculation .claude/skills/vat-calculation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vat-calculation
GitHub stars
148
Token cost
~894 tokens
SKILL.md length
228 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
None found

At a glance

Calculates value-added tax from a tax-inclusive sales amount, VAT rate and input tax using a calculator tool, with risk checks and filing suggestions.

  • Works in 5 steps: Collect Required Parameters → Calculate Using Tool → Compliance Check (if risk_issues… → …
  • Calculating the VAT payable on a sales amount after deducting input tax
  • SKILL.md covers Overview, Workflow, Error Handling and Gotchas
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent gathers three inputs: the tax-inclusive sales amount, the VAT rate (13%, 9%, 6%, 3% or 1%, defaulting to 13%) and an optional input tax figure. Percentages are converted to decimals, a general taxpayer with no stated rate gets 13% and a small-scale taxpayer gets 3%. It then calls `tax_calculator` instead of doing the arithmetic itself, and the tool returns output tax, input tax, payable VAT, a list of risk issues and recommendations.

If risk issues come back, the `tax_compliance_checker` tool produces a compliance report. Results are shown as a structured summary in Chinese, including a note on carry-forward credit when the payable amount is negative, and the agent offers follow-ups such as corporate income tax through the `corporate-tax-check` skill, a policy lookup or a CSV export. Rates outside the legal list and zero sales amounts trigger warnings, and a direct formula in Python is the fallback if the tool fails. Export rebates and tax-exempt sales are out of scope.

When your agent uses it

  • Calculating the VAT payable on a sales amount after deducting input tax
  • Checking a VAT rate against the legal list before filing
  • Getting risk flags and filing recommendations for a VAT figure
  • Exporting VAT calculation details to CSV

Example prompts

  • “Work out the VAT payable on our sales at the 13% rate after deducting input tax.”
  • “I'm a small-scale taxpayer, so compute VAT at the 3% rate for this month's sales.”
  • “Check whether this VAT calculation has any compliance risks.”
  • “Export the VAT calculation details to a CSV file.”

Requirements

  • Python 3
  • The `tax_calculator`, `tax_compliance_checker` and `execute_python` tools
  • Compatibility (from SKILL.md): Requires: python3 Tools: tax_calculator, tax_compliance_checker, execute_python
  • Pre-approved tools (allowed-tools): Bash, Read

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Collect Required Parameters
  2. Calculate Using Tool
  3. Compliance Check (if risk_issues non-empty)
  4. Present Result
  5. Follow-up

What it can do on your machine

Read from SKILL.md and the folder at commit 94b16cd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires: python3 Tools: tax_calculator, tax_compliance_checker, execute_python

    From compatibility in the SKILL.md frontmatter.

Context cost

VAT Calculation loads about 894 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 228 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~894

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 228 words (~894 tokens).

“Guide the user through a precise, auditable VAT (增值税) calculation. Follow the collect → calculate → validate → report workflow.”

— opening of SKILL.md by Serein-81
name
vat-calculation
allowed-tools
Bash, Read
compatibility
Requires: python3 Tools: tax_calculator, tax_compliance_checker, execute_python
when_to_use
Activate when the user needs a deterministic VAT calculation, not a general policy explanation. The skill: collects parameters → calls tax_calculator tool for…
metadata.author
internal-tax-team
metadata.version
1.0
metadata.domain
tax

Read the full SKILL.md on GitHub

Files

Just SKILL.md in rag_backend/skills/tax/vat-calculation of Serein-81/financial_rag.

Open the folder on GitHubat commit 94b16cd

Compare with similar skills

VAT Calculation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

VAT Calculation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
VAT Calculation this skillSerein-81/financial_rag148—~894Automated safety check: NotesNone
Brokerage Screenshot Trade Extractorguilhermecgs/ir179—~1.2kAutomated safety check: PassMPL-2.0
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT
CICPA Company Registration Querynigo81/nigo-skills133—~2.8kAutomated safety check: PassMIT
Beancount Importer Authorbex-co/beancount-io297—~2kAutomated safety check: PassMIT
Travel Expense ReimbursementFoxtailsss-Andy/Anna-Agent147—~812Automated safety check: PassMIT

Similar skills

  • Reads screenshots of brokerage or portfolio transaction tables, checks the rows for duplicates and prints lines you can paste into your operations file by hand.

    179 GitHub stars~1.2k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed
  • Looks up Chinese company registration data in the CICPA industry knowledge base, from a quick search to a full 61-dimension export, subsidiary discovery and Excel output.

    133 GitHub stars~2.8k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Beancount Importer Author

    bex-co/beancount-io

    Write or repair a reusable Beangulp importer from a sample bank export, with reviewed golden files and a passing test harness.

    297 GitHub stars~2k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Travel Expense Reimbursement

    Foxtailsss-Andy/Anna-Agent

    Create, validate, submit, and verify employee travel and expense reimbursements through Anna Cowork and MCP.

    147 GitHub stars~812 tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Merges bank statements from several banks and formats into one standard Excel layout, then reconciles them against the general ledger with a layered matching engine.

    133 GitHub stars~1.3k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from Serein-81/financial_rag

  • Enterprise Tax Profile Matching

    Serein-81/financial_rag

    Builds a six-dimension profile of a company and matches it against tax policies to find applicable incentives, obligations, risks and optimization options.

    148 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Financial Data Entry

    Serein-81/financial_rag

    Guides entry of a single financial record by collecting fiscal-year figures, validating them with a script and confirming before submitting to the financial-data API.

    148 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Legal Compliance Search

    Serein-81/financial_rag

    Looks up current company registration rules, industry licences and compliance obligations in China through live web search, tailored to the business profile.

    148 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check: notes
  • Tax Law Research

    Serein-81/financial_rag

    Searches current Chinese tax laws, rates and policy changes with Tavily web search, prioritizing government sources and flagging outdated or conflicting results.

    148 GitHub stars~997 tokensUpdated 4 mo ago
    Auto-check: notes
  • Policy Crawl Pipeline

    Serein-81/financial_rag

    Guides a policy notification agent through crawling government policy sources, saving them locally, matching them to enterprise profiles and generating notifications.

    148 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check: notes
  • Chinese Corporate Income Tax Check

    Serein-81/financial_rag

    Calculates China's corporate income tax with automatic preferential-rate detection for small or high-tech enterprises, then checks compliance.

    148 GitHub stars~787 tokensUpdated 4 mo ago
    Auto-check: notes

Works with

Questions about VAT Calculation

What does VAT Calculation do?

Calculates value-added tax from a tax-inclusive sales amount, VAT rate and input tax using a calculator tool, with risk checks and filing suggestions. The agent gathers three inputs: the tax-inclusive sales amount, the VAT rate (13%, 9%, 6%, 3% or 1%, defaulting to 13%) and an optional input tax figure. Percentages are converted to decimals, a general taxpayer with no stated rate gets 13% and a small-scale taxpayer gets 3%.

When should I use VAT Calculation?

VAT Calculation fits situations like: calculating the VAT payable on a sales amount after deducting input tax; checking a VAT rate against the legal list before filing; getting risk flags and filing recommendations for a VAT figure; exporting VAT calculation details to CSV.

How do I install VAT Calculation in Claude Code?

Run `npx skills add Serein-81/financial_rag --skill vat-calculation -a claude-code`. Or copy the skill folder (rag_backend/skills/tax/vat-calculation in Serein-81/financial_rag) into .claude/skills/vat-calculation in your project. Claude Code loads it when a task matches its description.

How do I install VAT Calculation in Codex?

Run `npx skills add Serein-81/financial_rag --skill vat-calculation -a codex`. Or copy the skill folder (rag_backend/skills/tax/vat-calculation in Serein-81/financial_rag) into .agents/skills/vat-calculation in your project. Codex loads it when a task matches its description.

Can I use VAT Calculation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Serein-81/financial_rag --skill vat-calculation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vat-calculation, .gemini/skills/vat-calculation, .github/skills/vat-calculation and .opencode/skills/vat-calculation in your project.

What does VAT Calculation need to run?

SKILL.md names no scripts, command-line tools or credentials: VAT Calculation is instructions for the agent only. Our summary lists: Python 3; The `tax_calculator`, `tax_compliance_checker` and `execute_python` tools. Its frontmatter pre-approves these tools: Bash, Read. Compatibility (from SKILL.md): Requires: python3 Tools: tax_calculator, tax_compliance_checker, execute_python .

Does VAT Calculation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is VAT Calculation safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does VAT Calculation use?

No licence was found for VAT Calculation or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does VAT Calculation use?

About 894 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to VAT Calculation?

Skills that share tags, products or a category with VAT Calculation: Brokerage Screenshot Trade Extractor (guilhermecgs/ir, 179 stars), Itr Wala (karanb192/itr-wala, 871 stars), CICPA Company Registration Query (nigo81/nigo-skills, 133 stars) and Beancount Importer Author (bex-co/beancount-io, 297 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains VAT Calculation?

Serein-81 (a GitHub user) maintains it in Serein-81/financial_rag, which has 148 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on June 5, 2026.

Source: Serein-81/financial_rag on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.