paycheck

What This Skill Does

The Paycheck skill is a specialized utility toolkit designed for OpenClaw AI agents to manage, track, and analyze financial data related to payroll and compensation. It functions as a local logging and analysis engine, allowing users to keep a meticulous record of income, deductions, and tax withholdings without ever exposing sensitive financial information to the cloud. By utilizing a modular command structure, the skill enables users to log specific financial events, generate reports, and compare different compensation scenarios. Data is stored locally in a structured directory, ensuring privacy while providing robust tools for data retrieval, such as keyword searching and automated export options in JSON, CSV, or TXT formats.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/ckchzh/paycheck Ensure that your OpenClaw configuration allows for local file system access, as this skill writes log entries to your home directory under ~/.local/share/paycheck/ to maintain a persistent history of your financial data.

Use Cases

This skill is ideal for employees looking to verify the accuracy of their pay stubs, contractors tracking multiple income streams, or financial analysts modeling the impact of changing tax brackets and retirement contributions. It is particularly effective for users who need to maintain a long-term ledger of earnings across different employers or pay periods, allowing for easy historical analysis and trend identification through the built-in stats and export features.

Example Prompts

1. "Paycheck, record a check entry for $2,450 from my main employer dated for this week."
2. "Compare my last three paycheck analyze entries and tell me the total amount deducted for taxes."
3. "Export all my recorded paycheck history to a CSV file so I can review it in Excel."

Tips & Limitations

To maximize the utility of the Paycheck skill, make sure to use descriptive inputs for your commands to ensure that the search function remains effective. Because all data is stored locally in plain-text logs, be aware that you are responsible for the physical security of your machine and any backups of the ~/.local/share/paycheck/ directory. This skill does not perform real-time calculations based on live tax law databases; it acts as a record-keeping and data-management tool for the values you input. It is best used for historical tracking and basic arithmetic-based comparisons rather than complex, automated financial planning.