vn-payroll

Calculate Vietnamese net income, PIT, and BHXH using 2025 rules.

5|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/arisng/github-copilot-fc --skill vn-payroll
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vn-payroll
Source: https://github.com/arisng/github-copilot-fc/tree/main/skills/vn-payroll
Command: npx skills add https://github.com/arisng/github-copilot-fc --skill vn-payroll

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill computes net income, Personal Income Tax (PIT), and social insurance contributions for Vietnamese salaries, using official 2025 progressive tax brackets.

Core Features & Use Cases

  • Payroll breakdown: Calculate net take-home pay after mandatory social and health insurance contributions and PIT based on gross salary, dependents, and region.
  • Configurable deductions: Applies standard personal deduction and dependent deductions per Vietnam rules, with a region-based wage cap.
  • Use Case: Imagine a payroll officer needs to generate a monthly breakdown for 50,000,000 VND gross with 1 dependent—this tool outputs net income, PIT, and insurance with a clear breakdown.

Quick Start

Run the Python script with the required arguments to compute a payroll breakdown. Example: python calc_pit.py --gross 50000000 --dependents 1 --region 1

Frequently Asked Questions about vn-payroll

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

FAQPage Schema
How do I calculate net income and PIT for a Vietnamese salary?

Vietnam payroll calculation includes mandatory social insurance, health insurance, and PIT. This Skill computes these deductions from gross salary using 2025 official progressive tax brackets, standard personal deductions, dependent deductions, and region-based wage caps.

How do I compute BHXH and PIT for a 50,000,000 VND gross salary?

You compute BHXH and PIT for a 50,000,000 VND gross salary by passing the gross amount, dependents, and region as arguments to the Python script. The tool processes standard deductions and insurance caps to return the exact tax owed and net income.

Does the Vietnam payroll calculator support dependents and regional wage caps?

Yes, the Vietnam payroll calculator supports dependents and regional wage caps. It applies standard dependent deductions and uses the region argument to enforce the correct wage caps for social insurance calculations.

Can I run the Vietnam payroll calculation locally with Python?

Yes, you can run the Vietnam payroll calculation locally using Python. The Skill relies on a standalone Python script that accepts command-line arguments for gross salary, dependents, and region to output the payroll breakdown.

What are the limitations of using a script for vn payroll calculations?

A limitation of using a script for vn payroll calculations is that it relies on manual command-line execution and hardcoded 2025 tax rules. It does not automatically fetch external regulatory updates or integrate directly into automated HR databases.