Streamline Your IR56B Tax Filing Preparation Scripts with HKHR-Skills
•AI

Streamline Your IR56B Tax Filing Preparation Scripts with HKHR-Skills

By Administrator
课程Vibe Coding & Tech Startup 创业课程结合 AI 辅助编程与创业思维：从灵感到原型、迭代到上线，一步步把想法做成可用的产品。前往课程页查看完整大纲、上课方式与报名／咨询渠道。查看课程大纲与详情 →

For SMEs operating in Hong Kong, managing HR data and tax compliance can be a significant administrative burden. If you are looking for a more efficient way to handle payroll and tax documentation, the HKHR-Skills repository is an essential tool.

This project is an Agent Skill project designed for use with AI agents (such as Cursor or Claude Code). It provides a structured, SQLite-backed toolkit that empowers AI assistants to handle complex HR workflows, including payroll-adjacent processing, employee management, and, most importantly, IR56B tax filing preparation scripts.

Why Use HKHR-Skills for Tax Preparation?

Manual tax filing preparation is prone to errors. HKHR-Skills automates this by maintaining a one-to-one IR56B profile extension for each employee.

Key IR56B Features:

  • Readiness Checks: The toolkit evaluates your data and returns a list of missing fields, ensuring you are ready for submission before the deadline.
  • Excel Integration: Generate IR56B workbook templates to simplify data gathering.
  • Data Integrity: Store critical details like HKID, passport, and address blocks directly within the linked SQLite database.

Core Capabilities of the Toolkit

Beyond tax filing, the repository covers the full employee lifecycle with dedicated modules:

  • Employee: Manage master records with strict uniqueness constraints.
  • Lifecycle: Use reusable templates for onboarding and offboarding tasks.
  • Compliance: Track work eligibility and contract validity with ease.
  • Leave: Manage leave type catalogs and application workflows.
  • ADW (Average Daily Wage): Infer payroll data from Excel workbooks to calculate accurate payouts.

Getting Started

To begin using these scripts, ensure you have Python 3.10+ installed. Follow these steps:

  1. Clone the repository and navigate to the project root.
  2. Install dependencies: Run pip install -r requirements.txt.
  3. Initialize the database: Execute python scripts/init_employee.py to set up your SQLite structure.

AI-First Workflow

This project is built for automation. When using an AI agent:

  1. Classify: Ask the AI to identify the correct module (e.g., IR56B for tax or ADW for payroll).
  2. Command: Request the AI to run the corresponding script. The tool returns JSON outputs, making it easy for the AI to parse results and summarize them for you.
  3. Verify: Always ask the AI to display the command before it executes, especially for write operations.

Security and Privacy

HR data is sensitive. This toolkit is designed to keep your data local. By default, your database is stored at ~/.hkhrcore/hrcore.db (or a location of your choice via the EMPLOYEE_DB_PATH environment variable). For maximum security, use this tool with local, on-device LLMs rather than sending sensitive employee information to external cloud APIs.

Ready to optimize your HR operations? Explore the HKHR-Skills repository on GitHub today.