← Back to Skills Marketplace
irreel

tax-filing

by Anthea Z · GitHub ↗ · v0.2.0
cross-platform ✓ Security Clean
306
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install tax-filing
Description
United States federal income tax filing assistant for US citizens, resident aliens, and nonresident aliens. Guides users through the entire IRS filing workfl...
Usage Guidance
This skill appears internally consistent: it contains helpful reference docs and a small pypdf helper to update IRS PDF fields. Before installing or running it, verify you trust the skill source and run it locally (do not upload sensitive tax docs to unknown services). Review scripts/update_form.py yourself (it is short and does no networking). Ensure pypdf is installed in a safe environment and avoid running code from unknown authors with your real SSN/financial documents; consider consulting a tax professional for complex or high‑risk filings.
Capability Analysis
Type: OpenClaw Skill Name: tax-filing Version: 0.2.0 The tax-filing skill bundle is a well-documented assistant for preparing US federal income tax returns (Forms 1040 and 1040-NR). It includes a Python utility script, `scripts/update_form.py`, which safely handles PDF form field updates using the `pypdf` library while implementing specific safeguards against file corruption and data loss. The instructions in `SKILL.md` and the supporting reference files provide legitimate tax logic, field mappings, and validation rules without any evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description (US federal tax filing + PDF form filling) match the included references and the bundled pypdf-based update_form.py script; the files and guidance are proportional to preparing and validating 1040/1040‑NR workflows.
Instruction Scope
SKILL.md restricts actions to gathering user-provided tax documents, routing forms, calculating amounts, and filling/validating PDFs. It does not instruct reading unrelated system files or contacting external endpoints. The directive to activate on any tax-related user prompt is broad but consistent with the skill's purpose.
Install Mechanism
This is an instruction-only skill with no install spec. The only runtime dependency is pypdf (checked in scripts/update_form.py). No downloads, URLs, or archive extraction are present.
Credentials
The skill declares no required environment variables, credentials, or config paths. The workflow legitimately needs access to user tax documents (W‑2, 1099s, etc.), which is appropriate for the stated purpose.
Persistence & Privilege
always:false and default invocation settings are used. The skill does not request permanent system presence or modify other skills' configurations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tax-filing
  3. After installation, invoke the skill by name or use /tax-filing
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
- Version number aligned - Added complete support for nonresident alien (NRA) workflows (Form 1040-NR, treaty-based returns) directly in this skill. - Bundled the safe PDF form update script in `scripts/update_form.py` (no more external dependency). - Introduced detailed PDF recovery instructions and critical pypdf safety rules for reliable form filling. - Expanded references to include full field mappings (`references/form-field-maps.md`) and technical PDF handling guidance. - Updated routing and handling to support all US federal filers and workflows, including end-to-end PDF generation and validation.
v0.1.1
- Added complete support for nonresident alien (NRA) workflows (Form 1040-NR, treaty-based returns) directly in this skill. - Bundled the safe PDF form update script in `scripts/update_form.py` (no more external dependency). - Introduced detailed PDF recovery instructions and critical pypdf safety rules for reliable form filling. - Expanded references to include full field mappings (`references/form-field-maps.md`) and technical PDF handling guidance. - Updated routing and handling to support all US federal filers and workflows, including end-to-end PDF generation and validation.
v0.1.0
- Initial release of the tax-filing skill for US federal income tax return preparation. - Guides users through the entire IRS workflow: determining filer type, filing status, needed forms, and calculating amounts from source documents. - Supports US citizens, resident aliens, and nonresident aliens, routing NRAs to the dedicated NRA plugin. - Provides step-by-step guidance for filling and validating IRS PDF forms, including detailed cross-form checks and common error avoidance. - US federal taxes only (no state, local, or non-US tax systems).
Metadata
Slug tax-filing
Version 0.2.0
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is tax-filing?

United States federal income tax filing assistant for US citizens, resident aliens, and nonresident aliens. Guides users through the entire IRS filing workfl... It is an AI Agent Skill for Claude Code / OpenClaw, with 306 downloads so far.

How do I install tax-filing?

Run "/install tax-filing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is tax-filing free?

Yes, tax-filing is completely free (open-source). You can download, install and use it at no cost.

Which platforms does tax-filing support?

tax-filing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created tax-filing?

It is built and maintained by Anthea Z (@irreel); the current version is v0.2.0.

💬 Comments