salary-wage-accounting – Other skill for AI agents

Salary & Wage Accounting

What it is: Payroll booked, paid and reconciled against attendance and statutory liabilities.

Overview

Works out the smallest useful Salary & Wage Accounting setup for the business in front of it, then

builds it only when asked. The default output is a short recommendation, not a

spreadsheet. Artifacts - CSV, SQL DDL, JSON Schema, Notion mapping - are produced on

request, from one field list so they cannot drift apart.

This skill produces an empty template only. It never holds or processes real salary or

employee data. Payroll calculation and statutory filing stay with a qualified person -

this holds what was paid, what was deducted and what is still owed.

Layer: Layer 5: Expense & Payroll. Fits: Growth stage. Table code: n/a.

When to Use This Skill

• payroll register
• salary book
• wage sheet record
• payroll liability tracker

Also use it when the user says "payroll booked, paid and reconciled against attendance and statutory liabilities", or describes the same process happening in a

spreadsheet, a document or someone inboxes.

Do not use it for: payroll calculation, statutory filing, or tax advice. This skill produces

empty templates only - it never holds or processes real employee or customer data.

How It Works

No separate shared execution contract is bundled; follow this file and current host/user instructions. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.

Step 1 - Identify intent

Read the request and pick the intent before asking anything.

• "set up" or "build" or "create" -> the user wants artifacts; go to Step 2.
• "our process is ..." or "it is in a sheet" -> the user wants to move an existing process; capture it, then Step 2.
• "is this right" or "review" or "audit" -> the user wants a check, not a build; answer from what they share.
• "how do I ..." -> advice question; answer directly and offer the build only if it helps.

Ask only if this is the highest-value missing fact; otherwise proceed without an opener:

> Q: How many people are on the payroll each month?

Step 2 - Ask only what is missing

Treat ambiguous replies as unanswered and ask which explicit option the user means. Record unknown values as Unknown; Unknown is not zero. A record must not be Done when a required check fails.

Skip anything the user already answered, in any earlier message. Ask the rest one at a

time, and stop as soon as the remaining answers would not change the output.

• Workforce - How many employees? / Salaried or hourly? / Where is attendance recorded?
• Pay cycle - When is the run cut? / Who prepares the wage sheet? / Who approves payment?
• Deductions - TDS? / SSF/PF or equivalent? / Any advance recovery or other deductions?
• Statutory - Who deposits and files? / How often is it reconciled? / Is a liability carried?
• Outcome - What do you need? / A payroll record, a liability tracker or both?

Never invent an answer. If the user does not know, record it as unknown and carry on.

Step 3 - Hold the internal context

Hold the answers in this shape. It stays internal - it is not shown to the user unless

they ask, and it never carries a value the user did not give.

module: salary-wage-accounting
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Workforce": null
  "Pay cycle": null
  "Deductions": null
  "Statutory": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

Step 4 - Recommend the smallest workflow

Build an already requested artifact without asking again. For advice-only requests, give a short recommendation and offer the relevant artifact.

Recommended approach: One record per employee per pay run holding the period, the days, the gross, the deductions and the net, and let the payroll package do the calculation.

Why this one: The arithmetic belongs in payroll software. This holds what was paid, what was deducted and what is still owed, so a reviewer can check the sheet without redoing it.

Workflow: Attendance recorded → Wage sheet prepared → Approved → Paid → Liability carried → Statutory reconciled

Step 5 - Build only on request

Once the user asks for it, derive the fields from the confirmed context and emit the

requested artifacts. For machine-readable text, keep prose outside the data; for files,

provide a usable link. Report material validation failures or limitations separately.

**A selected Notion output is rendered by notion-manual-import, so route the

Notion step there.** When the user selects Notion, hand that step to

@notion-manual-import: it holds the CSV, the property

mapping, the import steps and the verification checklist, and it renders the Field

Reference below instead of defining a table of its own. Do not restate the mapping

here and do not improvise the import steps. Manual CSV and mapping outputs need no

connection. For requested workspace changes, follow the shared contract: verify actual

tool access and the target before writing. A user saying "connected" is not tool evidence.

Never ask for a Notion password or token.

Payroll Run,Employee,Employee ID,Department,Period Start,Period End,Attendance Days,Paid Days,Gross Salary/Wages,Allowances,Deductions,TDS,SSF/PF Contribution,Other Deductions,Net Salary/Wages,Payment Date,Payment Mode,Ledger Account,Approval Reference,Payroll Liability Balance,Statutory Reconciliation Status,Source Document,Prepared By,Reviewed By,Status,Notes,Salary Record ID
PAYRUN-2026-08,Rohit Menon,EMP-0114,Operations,2026-08-01,2026-08-31,26,26,96000.00,8400.00,1600.00,3600.00,7680.00,500.00,91020.00,2026-08-28,Bank Transfer,Salaries & Wages,APR-PR-2026-08,11280.00,Pending,DOC-2026-0470,Sneha Iyer,Ananya Rao,In progress,"Synthetic: base gross excludes allowances; total employee deductions 13380.00. TDS 3600.00 plus employee PF 7680.00 remain undeposited; other deductions already settled.",SAL-ID-0114

CREATE TABLE salary_wage_accounting (
  payroll_run VARCHAR(255),
  employee VARCHAR(255),
  employee_id VARCHAR(255),
  department VARCHAR(100) NOT NULL,
  period_start DATE NOT NULL,
  period_end DATE NOT NULL,
  attendance_days NUMERIC,
  paid_days NUMERIC,
  gross_salary_wages NUMERIC(14,2),
  allowances NUMERIC(14,2),
  deductions NUMERIC(14,2),
  tds NUMERIC(14,2),
  ssf_pf_contribution NUMERIC(14,2),
  other_deductions NUMERIC(14,2),
  net_salary_wages NUMERIC(14,2),
  payment_date DATE,
  payment_mode VARCHAR(100) NOT NULL,
  ledger_account VARCHAR(255),
  approval_reference VARCHAR(255),
  payroll_liability_balance NUMERIC(14,2),
  statutory_reconciliation_status VARCHAR(100) NOT NULL,
  source_document VARCHAR(255),  -- relation -> target record
  prepared_by VARCHAR(255),
  reviewed_by VARCHAR(255),
  status VARCHAR(100) NOT NULL,
  notes TEXT,
  salary_record_id VARCHAR(255) PRIMARY KEY,
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);

CREATE INDEX idx_salary_wage_accounting_status ON salary_wage_accounting (status);

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Salary & Wage Accounting",
  "type": "object",
  "additionalProperties": false,
  "properties": {
      "Payroll Run": { "type": "string" },
      "Employee": { "type": "string" },
      "Employee ID": { "type": "string" },
      "Department": { "type": "string" },
      "Period Start": { "type": "string", "format": "date" },
      "Period End": { "type": "string", "format": "date" },
      "Attendance Days": { "type": "number" },
      "Paid Days": { "type": "number" },
      "Gross Salary/Wages": { "type": ["number", "null"] },
      "Allowances": { "type": ["number", "null"] },
      "Deductions": { "type": ["number", "null"] },
      "TDS": { "type": ["number", "null"] },
      "SSF/PF Contribution": { "type": ["number", "null"] },
      "Other Deductions": { "type": ["number", "null"] },
      "Net Salary/Wages": { "type": ["number", "null"] },
      "Payment Date": { "type": "string", "format": "date" },
      "Payment Mode": { "type": "string" },
      "Ledger Account": { "type": "string" },
      "Approval Reference": { "type": "string" },
      "Payroll Liability Balance": { "type": ["number", "null"] },
      "Statutory Reconciliation Status": { "type": "string" },
      "Source Document": { "type": "string" },
      "Prepared By": { "type": "string" },
      "Reviewed By": { "type": "string" },
      "Status": { "type": "string" },
      "Notes": { "type": "string" },
      "Salary Record ID": { "type": "string" }
  },
  "required": [
      "Department",
      "Period Start",
      "Period End",
      "Gross Sa

… (full content is in the download package)