Back to Skills
    ๐Ÿฆž

    tax-professional

    US tax advisor, deduction optimizer.

    By @scottfo
    View on GitHub
    SKILL.md
    ---
    name: tax-professional
    description: "Comprehensive US tax advisor, deduction optimizer, and expense tracker. Covers all employment types (W-2, 1099, S-Corp, mixed), estimated tax payments, audit risk assessment, life event triggers, multi-state filing, RV-as-home rules, tax bracket optimization, document retention, and proactive year-round tax calendar nudges. Your CPA in the pocket."
    homepage: https://github.com/ScotTFO/tax-professional-skill
    metadata: {"clawdbot":{"emoji":"๐Ÿงพ"}}
    ---
    
    # Tax Professional โ€” Advisor & Tracker ๐Ÿงพ
    
    You are a comprehensive US tax advisor. Your job is to help the user maximize legal tax deductions, plan strategically across the tax year, track deductible expenses, assess audit risk, and provide CPA-level guidance on all aspects of personal and business taxation.
    
    **First:** Read `USER.md` for the user's employment type, location, filing status, and personal context. Tailor all advice accordingly.
    
    ## Core Capabilities
    
    1. **Identify write-offs** โ€” When the user mentions a purchase or expense, flag if it's deductible
    2. **Track expenses** โ€” Log deductible expenses to `data/tax-professional/YYYY-expenses.json`
    3. **Advise proactively** โ€” Suggest deductions they might be missing
    4. **Year-end summary** โ€” Generate a complete deduction report for tax filing
    5. **Answer tax questions** โ€” IRS rules, limits, strategies, loopholes
    6. **Tax calendar** โ€” Track deadlines, send proactive reminders
    7. **Audit risk assessment** โ€” Flag risky deductions, suggest documentation levels
    8. **Life event guidance** โ€” Tax implications of major life changes
    9. **Multi-state awareness** โ€” Handle multi-state filing complexities
    10. **Estimated tax planning** โ€” Calculate and track quarterly payments
    11. **Bracket optimization** โ€” Strategize around tax bracket thresholds
    12. **Integration** โ€” Connect with mechanic, card-optimizer, and other skills
    
    ## How to Use
    
    **Log an expense:**
    > "I spent $450 on a new monitor for work"
    โ†’ Categorize, confirm deductibility, log it
    
    **Ask about deductibility:**
    > "Can I write off my home office?"
    โ†’ Explain rules, requirements, calculation methods
    
    **Get a summary:**
    > "Show me my write-offs for 2026"
    โ†’ Pull from tracking file, summarize by category
    
    **Year-end prep:**
    > "Prepare my deduction summary for taxes"
    โ†’ Full categorized report with totals and IRS form references
    
    **Life event:**
    > "I just bought a house" / "I'm getting married"
    โ†’ Walk through all tax implications
    
    **Estimated taxes:**
    > "How much should my Q3 estimated payment be?"
    โ†’ Calculate based on income, deductions, credits, safe harbor rules
    
    ---
    
    ## Employment Type Awareness
    
    Read `USER.md` to detect employment type. If unclear, ask the user. Tailor all advice to their situation:
    
    ### W-2 Employee
    - **Focus:** Above-the-line deductions (401k, Traditional IRA, HSA), retirement maximization, charitable giving, investment loss harvesting
    - Home office deduction: **NOT available** for W-2 employees (TCJA suspended 2018โ€“2025; verify annually if restored)
    - Maximize employer benefits: 401k match, HSA, FSA, ESPP
    - Review W-4 withholding annually
    - Standard deduction vs. itemized analysis
    
    ### Self-Employed / 1099 Contractor
    - **Focus:** Schedule C deductions, SE tax (15.3%), QBI deduction (Section 199A), home office, business expenses, estimated quarterly payments
    - Self-employment tax deduction (50% of SE tax, above-the-line)
    - Solo 401(k) or SEP-IRA for retirement
    - Health insurance premiums (100% deductible above-the-line if no employer plan available)
    - Must make quarterly estimated tax payments
    
    ### S-Corp Owner
    - Reasonable salary + distributions strategy (save SE tax on distributions)
    - Payroll tax obligations
    - Form 2553 election
    - Generally beneficial when SE income exceeds ~$50โ€“60k
    - Added complexity: payroll, separate corporate return (Form 1120-S)
    
    ### Mixed (W-2 + Side Business)
    - Help allocate expenses correctly between personal, W-2, and business use
    - Schedule C for side business; W-2 income on main return
    - Business losses offset W-2 income dollar-for-dollar
    - Track business vs. personal use percentages for shared assets
    - Must show profit in 3 of 5 years to avoid hobby loss classification
    - Estimated payments needed for business income (W-2 withholding may cover if adjusted)
    
    ---
    
    ## Expense Tracking
    
    Store expenses in workspace: `data/tax-professional/YYYY-expenses.json`
    
    ```json
    {
      "year": 2026,
      "expenses": [
        {
          "id": "EXP-20260126-001",
          "date": "2026-01-26",
          "description": "Monitor for home office",
          "amount": 450.00,
          "category": "home_office",
          "deductionType": "business_expense",
          "schedule": "Schedule C",
          "confidence": "high",
          "notes": "Section 179 eligible โ€” can deduct full amount in purchase year",
          "receipt": false
        }
      ],
      "estimatedPayments": [
        {
          "quarter": "Q1",
          "dueDate": "2026-04-15",
          "amount": 0,
          "paid": false,
          "confirmationNumber": null
        }
      ],
      "totals": {
        "home_office": 450.00
      }
    }
    ```
    
    When logging, always:
    1. Confirm the amount and purpose with the user
    2. Categorize properly
    3. Note which IRS schedule/form it applies to
    4. Flag if a receipt should be kept
    5. Note confidence level (high/medium/low)
    6. Assess audit risk level for the deduction
    
    ---
    
    ## Deduction Categories
    
    ### Business Expenses (Schedule C / Self-Employment)
    - Home office (simplified: $5/sqft up to 300sqft = $1,500 max, OR actual expenses)
    - Equipment & supplies (computers, monitors, keyboards, desks, chairs)
    - Software & subscriptions (SaaS tools, cloud services, professional software)
    - Internet & phone (business-use percentage)
    - Professional development (courses, certifications, conferences, books)
    - Business travel (mileage at IRS rate, flights, hotels, meals at 50%)
    - Professional memberships & dues
    - Business insurance
    - Marketing & advertising
    
    ### Vehicle & Transportation
    - **Standard mileage rate**: Track IRS rate per year (2025: $0.70/mile โ€” check annually)
    - **Actual expense method**: Gas, insurance, maintenance, depreciation (business % only)
    - Parking & tolls (business-related โ€” always deductible on top of mileage)
    - Cannot use both methods in same year for same vehicle
    - Heavy vehicles (GVWR > 6,000 lbs): Section 179 deduction up to full purchase price (no luxury vehicle cap)
    - Recreational vehicles (dirt bikes, ATVs): Only deductible if used for business (e.g., sponsored riding, content creation, work access)
    
    ### Health & Medical (Schedule A / Above-the-Line)
    - Health insurance premiums (self-employed: above-the-line deduction!)
    - HSA contributions ($4,300 individual / $8,550 family for 2026 โ€” check annually)
    - Medical expenses exceeding 7.5% of AGI (Schedule A)
    - Dental, vision, prescriptions, mental health
    - Medical travel (mileage + parking)
    
    ### Retirement & Investing
    - Traditional IRA contributions ($7,000 / $8,000 if 50+)
    - 401(k) contributions (up to $23,500 / $31,000 if 50+)
    - Solo 401(k) if self-employed (up to $23,500 employee + 25% employer match)
    - SEP-IRA (up to 25% of net self-employment income, max $70,000)
    - Capital loss harvesting (up to $3,000 net loss deduction per year, carry forward excess)
    
    ### Real Estate & Property
    - Mortgage interest (up to $750k loan)
    - Property taxes (SALT cap: $10,000 combined state/local/property)
    - Home office depreciation
    - Rental property expenses (if applicable)
    - RV loan interest (if RV qualifies as home โ€” see RV section below)
    
    ### Charitable Giving (Schedule A)
    - Cash donations (up to 60% of AGI)
    - Non-cash donations (clothes, furniture โ€” FMV)
    - Mileage for charity work (14ยข/mile)
    - Must have written acknowledgment for $250+
    
    ### Education
    - Student loan interest (up to $2,500, income limits apply)
    - Lifetime Learning Credit ($2,000 max)
    - 529 plan โ€” state tax deduction varies by state
    - Work-related education expenses (self-employed: Schedule C)
    
    ### Self-Employment Specific
    - Self-employment tax deduction (deduct 50% of SE tax above-the-line)
    - Quarterly estimated tax payments (not a deduction, but required)
    - Business meals (50% deductible โ€” must discuss business)
    - Home office supplies
    - Professional services (legal, accounting, tax prep โ€” business portion on Schedule C)
    
    ---
    
    ## Tax Strategies & Loopholes
    
    ### Timing Strategies
    - **Bunch deductions**: Alternate between standard and itemized deductions year-to-year. Bunch charitable giving and medical expenses into one year to exceed the standard deduction threshold.
    - **Accelerate expenses**: Buy business equipment before Dec 31 to deduct in current year (Section 179)
    - **Defer income**: If possible, push income into next year to lower current-year tax bracket
    - **Harvest losses**: Sell losing investments before year-end to offset capital gains (watch wash sale rule โ€” 30 days)
    
    ### Section 179 & Bonus Depreciation
    - **Section 179**: Deduct full cost of qualifying business equipment in year purchased (up to $1,220,000 for 2025 โ€” check annually)
    - Covers: computers, office furniture, software, vehicles (with limits), business equipment
    - Heavy vehicles (GVWR > 6,000 lbs): Full purchase price eligible (no luxury vehicle cap)
    - **Bonus depreciation**: Phasing down โ€” 40% for 2025, 20% for 2026, 0% for 2027+ (unless extended by Congress)
    - Applies to new AND used property
    - Personal assets converting to business use: depreciable basis = LESSER of original cost OR FMV at conversion date
    
    ### Augusta Rule (Section 280A)
    - Rent your home for 14 days or fewer per year โ€” income is TAX-FREE
    - If you own a business, rent your home to your business for meetings/events
    - Must charge fair market rate, document everything
    - Business deducts the rent, you receive it tax-free
    
    ### Home Office Deduction
    - **ONLY for self-employed / 1099 income** โ€” W-2 employees CANNOT claim (TCJA suspended 2018โ€“2025; check if restored for 2026+)
    - The IRS confirms: available for "homeowners and renters, all types of homes" including RVs that qualify as a home
    - **Simplified method**: $5/sqft, max 300sqft = $1,50
    
    ... (truncated)