Payroll
Track employee wages, deductions, and payroll obligations for "$ARGUMENTS". Calculate gross and net pay, withholdings, and employer contributions.
Arguments. $ARGUMENTS may contain the project name and optional flags. Take the first token as <project> and treat --skip-checks as a flag; never include flags in file paths. All paths below use <project>. If --skip-checks is present, skip the prerequisite check and, before writing any artifact, append one line to .singularskills/log.jsonl: {"ts":"<ISO timestamp>","skill":"bookkeeping-payroll","workflow":"bookkeeping","phase":null,"project":"<project>","event":"skipped","artifact":"<artifact file>","note":"<reason or \"none given\">"}.
Compute with code. Perform every calculation (totals, balances, ratios, variances, projections) with a script — Bash, Python or a spreadsheet formula written to a file — and include the computation alongside the result. Never do arithmetic mentally.
Prerequisites
None — utility skill, run anytime.
Process
Gather employee information:
- List all employees and contractors
- Record: name, role, pay type (salary, hourly), rate, pay frequency
- Note tax filing status and allowances
- Identify any special deductions (benefits, garnishments, retirement)
Calculate gross pay:
- Salaried employees: annual salary / pay periods
- Hourly employees: hours worked x rate
- Include overtime, bonuses, commissions as applicable
- Track paid time off and sick leave balances
Calculate deductions:
- Employee withholdings: income tax, social security, medicare
- Employee contributions: health insurance, retirement (401k/pension), union dues
- Employer obligations: employer share of payroll taxes, insurance, workers' comp
- Other: garnishments, loan repayments
Determine net pay:
- Gross pay minus all employee deductions
- Verify against minimum wage requirements
- Calculate employer total cost per employee
Write the artifact to .singularskills/bookkeeping/<project>/payroll.md with sections:
- Payroll Summary — table with gross, deductions, and net per employee
- Withholdings Detail — breakdown of each deduction type
- Employer Costs — taxes and contributions paid by employer
- Totals — aggregate payroll cost for the period
- Upcoming Obligations — tax deposits and filing deadlines
Output
The payroll report written to .singularskills/bookkeeping/<project>/payroll.md. Present a summary highlighting:
- Total payroll cost (employee + employer)
- Net pay distributed
- Upcoming tax deposit deadlines
End the artifact with this paragraph, verbatim:
Not financial or tax advice. This artifact is generated analysis for review by a qualified accountant or financial professional before any filing, reporting or decision relies on it.
1---2name: bookkeeping-payroll3description: Calculate gross pay, withholdings, employer contributions and net pay per employee, with total payroll cost and upcoming tax deposit deadlines. Use when the user runs payroll for employees and wants the period's pay, deductions and employer obligations worked out.4metadata:5 source: https://skillmd.com/skills/bromso/bookkeeping-payroll6 argument-hint: "[project] [--skip-checks]"7---89# Payroll1011Track employee wages, deductions, and payroll obligations for "$ARGUMENTS". Calculate gross and net pay, withholdings, and employer contributions.1213**Arguments.** `$ARGUMENTS` may contain the project name and optional flags. Take the first token as `<project>` and treat `--skip-checks` as a flag; never include flags in file paths. All paths below use `<project>`. If `--skip-checks` is present, skip the prerequisite check and, **before writing any artifact**, append one line to `.singularskills/log.jsonl`: `{"ts":"<ISO timestamp>","skill":"bookkeeping-payroll","workflow":"bookkeeping","phase":null,"project":"<project>","event":"skipped","artifact":"<artifact file>","note":"<reason or \"none given\">"}`.1415**Compute with code.** Perform every calculation (totals, balances, ratios, variances, projections) with a script — Bash, Python or a spreadsheet formula written to a file — and include the computation alongside the result. Never do arithmetic mentally.1617## Prerequisites1819None — utility skill, run anytime.2021## Process22231. **Gather employee information:**24 - List all employees and contractors25 - Record: name, role, pay type (salary, hourly), rate, pay frequency26 - Note tax filing status and allowances27 - Identify any special deductions (benefits, garnishments, retirement)28292. **Calculate gross pay:**30 - Salaried employees: annual salary / pay periods31 - Hourly employees: hours worked x rate32 - Include overtime, bonuses, commissions as applicable33 - Track paid time off and sick leave balances34353. **Calculate deductions:**36 - **Employee withholdings:** income tax, social security, medicare37 - **Employee contributions:** health insurance, retirement (401k/pension), union dues38 - **Employer obligations:** employer share of payroll taxes, insurance, workers' comp39 - **Other:** garnishments, loan repayments40414. **Determine net pay:**42 - Gross pay minus all employee deductions43 - Verify against minimum wage requirements44 - Calculate employer total cost per employee45465. **Write the artifact** to `.singularskills/bookkeeping/<project>/payroll.md` with sections:47 - **Payroll Summary** — table with gross, deductions, and net per employee48 - **Withholdings Detail** — breakdown of each deduction type49 - **Employer Costs** — taxes and contributions paid by employer50 - **Totals** — aggregate payroll cost for the period51 - **Upcoming Obligations** — tax deposits and filing deadlines5253## Output5455The payroll report written to `.singularskills/bookkeeping/<project>/payroll.md`. Present a summary highlighting:56- Total payroll cost (employee + employer)57- Net pay distributed58- Upcoming tax deposit deadlines5960End the artifact with this paragraph, verbatim:6162> **Not financial or tax advice.** This artifact is generated analysis for review by a qualified accountant or financial professional before any filing, reporting or decision relies on it.