Payroll

A comprehensive AI agent skill for managing payroll accurately and on time. Helps small business owners run payroll without a dedicated HR function, explains payroll taxes and compliance requirements, handles contractor vs employee classification, prepares for audits, and ensures every person who works for you gets paid correctly every time.

3,891 stars

Best use case

Payroll is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

A comprehensive AI agent skill for managing payroll accurately and on time. Helps small business owners run payroll without a dedicated HR function, explains payroll taxes and compliance requirements, handles contractor vs employee classification, prepares for audits, and ensures every person who works for you gets paid correctly every time.

Teams using Payroll should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/payroll/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/agenticio/payroll/skill.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/payroll/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How Payroll Compares

Feature / AgentPayrollStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

A comprehensive AI agent skill for managing payroll accurately and on time. Helps small business owners run payroll without a dedicated HR function, explains payroll taxes and compliance requirements, handles contractor vs employee classification, prepares for audits, and ensures every person who works for you gets paid correctly every time.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Payroll

## The Obligation That Cannot Be Late

Of all the financial obligations a business carries, payroll is the one with zero tolerance for error and zero tolerance for delay. Vendors can wait. Rent can occasionally be negotiated. Payroll cannot. The employees who show up every day, perform work on the promise of compensation, and depend on that compensation to meet their own obligations are not creditors who can be managed. They are the reason the business functions at all.

Getting payroll wrong — late, incorrect, or non-compliant with the tax and reporting requirements that govern it — damages the trust that makes employment relationships work. It also creates legal and financial exposure that can follow a business for years. Payroll tax liabilities do not disappear. They accumulate penalties and interest and eventually become the kind of problem that threatens the business itself.

This skill ensures payroll is never that kind of problem.

---

## What Payroll Actually Involves

Most small business owners understand payroll as writing checks or initiating direct deposits. The actual scope is considerably broader.

Payroll begins with correctly classifying the people who work for you — employees versus independent contractors — because the classification determines the entire compliance framework that follows. It continues with calculating gross pay correctly for each pay period, accounting for hours, rates, overtime rules, and any variable compensation. It proceeds through the withholding calculations that determine what comes out of each paycheck — federal and state income tax, Social Security, Medicare, and any voluntary deductions. It concludes with the employer's own tax obligations — the matching contributions, the unemployment taxes, the reporting requirements that accompany every payroll run.

None of this is conceptually complex. All of it requires precision, because errors compound across pay periods and become significantly harder to correct the longer they persist.

---

## Employee vs Contractor Classification

The classification of workers as employees or independent contractors is one of the most consequential and most frequently incorrect decisions in small business. The appeal of contractor classification is real — no payroll taxes, no benefits obligations, no unemployment insurance, simpler administration. The risk is equally real — the IRS and state labor agencies apply specific tests to determine whether a worker is genuinely independent, and misclassification carries back taxes, penalties, and interest that can reach years into the past.

The skill helps you apply the relevant tests to your specific worker relationships. The behavioral control factors that indicate employment rather than independence. The financial control factors that distinguish a business relationship from an employment relationship. The type of relationship factors — written contracts, benefits, permanency — that support or undermine a contractor classification.

For workers whose classification is genuinely ambiguous, it helps you understand the risk you are carrying and the steps that either clarify the relationship or bring it into compliance.

---

## Payroll Taxes and Compliance

Payroll generates tax obligations on a schedule that does not adjust for how busy you are. Federal payroll tax deposits are due on a schedule determined by your deposit liability — some businesses deposit monthly, some semi-weekly, and the schedule can change as your liability grows. State obligations add their own layer of deadlines. Quarterly reporting adds another. Annual reconciliation adds another still.

The skill maintains a complete calendar of your payroll tax obligations. What is due, in what amount, to which agency, by which date. It calculates the employer's share of each obligation — the Social Security and Medicare matching contributions, the federal and state unemployment taxes — so that cash flow planning accounts for the full cost of payroll rather than just the net wages paid.

For businesses that have fallen behind on payroll tax deposits, it helps you understand the penalty structure you are facing and the options available for addressing the liability without compounding it further.

---

## Running Payroll Correctly

A payroll run that is correct every time is a system, not a talent. The system accounts for the variables that change each period — hours worked, overtime, commissions, bonuses, new hires, terminations, changes in withholding elections — and applies them accurately within the framework that remains constant.

The skill guides you through each payroll run with the completeness that prevents errors. It verifies that hours are captured for all hourly employees. It applies overtime rules correctly for the jurisdiction. It calculates gross pay, applies all required and voluntary deductions in the correct order, and produces the net pay figure that will be deposited or paid. It generates the payroll register that documents every element of every employee's compensation for the period.

For businesses using payroll software, it helps you use that software correctly — understanding what the system is doing so that you can catch errors rather than trusting outputs you cannot evaluate.

---

## New Hires and Terminations

Every new hire creates a set of payroll setup requirements that must be completed before the first paycheck is issued. The W-4 that establishes federal withholding. The state equivalent where applicable. The I-9 that verifies work authorization. The new hire reporting that most states require within a specific number of days of the hire date. The benefits enrollment that determines voluntary deductions.

Every termination creates its own requirements. Final pay timing rules that vary by state and carry penalties for non-compliance. COBRA notification obligations for benefits. The reporting that accompanies an employee's departure.

The skill walks through both processes completely so that every hire and every departure is handled correctly from the first day and the last.

---

## Preparing for a Payroll Audit

A payroll audit — whether conducted by the IRS, a state labor agency, or as part of a workers' compensation audit — is an examination of whether your payroll practices comply with the applicable rules. The businesses that navigate audits successfully are the ones whose records are complete, consistent, and organized before the auditor arrives.

The skill helps you maintain audit-ready payroll records. The documentation that supports every classification decision. The records that verify every withholding calculation. The filings that demonstrate every deposit was made on time. The personnel files that show every required form was completed and retained.

An audit is not something to fear if the underlying practices are correct and the records reflect them. The skill ensures both.

Related Skills

Payroll Compliance Auditor

3891
from openclaw/skills

Run a full payroll audit in under 10 minutes. Catches the errors that cost companies $845 per violation.

Payroll & HR Compliance

---

3891
from openclaw/skills

name: article-factory-wechat

Content & Documentation

humanizer

3891
from openclaw/skills

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Content & Documentation

find-skills

3891
from openclaw/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

General Utilities

tavily-search

3891
from openclaw/skills

Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.

Data & Research

baidu-search

3891
from openclaw/skills

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

Data & Research

agent-autonomy-kit

3891
from openclaw/skills

Stop waiting for prompts. Keep working.

Workflow & Productivity

Meeting Prep

3891
from openclaw/skills

Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.

Workflow & Productivity

self-improvement

3891
from openclaw/skills

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

Agent Intelligence & Learning

botlearn-healthcheck

3891
from openclaw/skills

botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.

DevOps & Infrastructure

linkedin-cli

3891
from openclaw/skills

A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.

Content & Documentation

notebooklm

3891
from openclaw/skills

Google NotebookLM 非官方 Python API 的 OpenClaw Skill。支持内容生成(播客、视频、幻灯片、测验、思维导图等)、文档管理和研究自动化。当用户需要使用 NotebookLM 生成音频概述、视频、学习材料或管理知识库时触发。

Data & Research