Agent skill · product strategy · sickn33
odoo-hr-payroll-setup
Expert guide for Odoo HR and Payroll: salary structures, payslip rules, leave policies, employee contracts, and payroll journal entries.
Why this skill is useful
Provides specific configurations and workflows for Odoo HR and Payroll that are not commonly known or documented publicly.
What it needs
Requires odoo installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Odoo HR & Payroll Setup Overview This skill guides HR managers and payroll accountants through setting up Odoo HR and Payroll correctly. It covers salary structure creation with Python-computed rules, time-off policies, employee contract types, and the payroll → accounting journal posting flow. When to Use This Skill Creating a salary structure with gross pay, deductions, and net pay. Configuring annual leave, sick leave, and public holiday policies. Troubleshooting incorrect payslip amounts or missing rule contributions. Setting up the payroll journal to correctly post to accounting. How It Works 1. Activate: Mention @odoo-hr-payroll-setup and describe your payroll scenario. 2. Configure: Receive step-by-step setup for salary rules and leave allocation. 3. Debug: Paste a salary rule or payslip issue and receive a root cause analysis. Examples Example 1: Salary Structure with Deductions Federal Income Tax: The standard Odoo US localization does not expose a single l10nusw4rate field. Use an input (salary input type) to pass the withholding rate per employee, or install a community US payroll module (OCA l10nushrpayroll) which handles W4 filing status properly. Example 2: Configure a Time Off Type Example 3: Payroll Journal Entry Result Best Practices ✅ Do: Install your country's payroll localization (l10nushrpayroll, l10nmxhrpayroll, etc.) before building custom rules — it provides pre-configured tax structures. ✅ Do: Use salary rule inputs (inputs.ALLOWANCE.amount) to pass variable values (bonuses, allowances, withholding rates) rather than hardcoding them in the rule formula. ✅ Do: Archive old salary structures rather than deleting them — active payslips reference their structure and will break if the structure is deleted. ✅ Do: Always set an active Employee Contract with correct dates and salary before generating payslips. ❌ Don't: Manually edit posted payslips — cancel and regenerate the payslip batch if corrections are needed. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/odoo-hr-payroll-setup