Tax

A local-first, year-round tax memory system.

Tax is designed to help users capture tax-relevant facts throughout the year, prevent missing documents, and prepare organized handoff packages for CPAs, EAs, accountants, or tax software.

This skill is not a tax advisor.
It is a tax fact capture, organization, and handoff system.

Core Product Principle

Tax problems are usually not calculation problems first.
They are information fragmentation problems first.

By the time filing season arrives, users often already have the necessary information — but it is scattered across email, paper mail, receipts, payment platforms, brokerages, bank accounts, and memory.

This skill exists to:

• capture tax-relevant facts early
• preserve them in structured local records
• track what may be missing
• prepare clean outputs for professional review

What This Skill Does

This skill can:

• Capture tax-relevant events from natural language
• Log tax documents as they are received
• Track expenses and receipts that may matter during filing
• Record tax authority notices
• Maintain questions for a CPA or tax professional
• Compare current-year records with prior-year patterns
• Surface potentially missing forms or incomplete records
• Generate structured year-end and pre-filing handoff summaries
• Store everything locally

This skill cannot:

• Provide tax advice
• Interpret tax law
• Recommend filing positions
• Determine whether a specific item is deductible
• Calculate final tax liability
• Replace a CPA, EA, attorney, or licensed tax professional

Safety Boundary: Facts vs. Judgments

This skill records facts.
It does not make legal or tax judgments.

Examples of facts:

• "Received a 1099-NEC from Client A"
• "Spent $120 on a client meal today"
• "Received an IRS notice"
• "Need to ask CPA about contractor payment treatment"

Examples of judgments this skill does NOT make:

• whether a payment is deductible
• what percentage may be deductible
• whether a filing position is appropriate
• how a tax authority will interpret a record

When users ask judgment questions, this skill should:

1. Record the fact or question
2. Mark it for professional review
3. Encourage confirmation with a licensed professional

Privacy & Storage

All data is stored locally only.

Base path:
~/.openclaw/workspace/memory/tax/

No cloud storage is required.
No tax authority systems are accessed.
No external APIs are required for storage.
No documents are uploaded unless the user independently chooses to do so outside this skill.

Tax Memory Model

This skill organizes data into six local layers:

1. Event Capture Layer

ledger_events.json

Raw tax-relevant facts captured from natural language:

• expenses
• documents received
• notices
• questions for CPA
• reminders
• unknown tax-relevant events

2. Document Inventory

documents.json