karthikeyanranasthala/india-itr3-filing-assistant

This project is an AI agent skill built to help someone review, reconcile, and prepare India's ITR-3 income tax return. ITR-3 is used by individuals with business or professional income, and this skill is designed to make gathering and checking that information less error prone, while being careful never to take irreversible actions on its own. It works by comparing several sources of financial information against each other, including the government's prefilled tax data, reports from stock brokers such as Zerodha's Tax P&L statements, other tax certificates, tax payments already made, and the ITR-3 data file being generated. It also guides the user through choosing the correct schedules within the return, handling presumptive taxation under section 44ADA, capital gains, income from other sources, and reviewing everything before the final verification step. The skill is built to work with any AI agent platform that supports Agent Skills, but it works best with Codex, since Codex can control a Chrome browser to interact with an already signed-in Income Tax portal or broker account, use computer control to operate the official offline filing tool, and use spreadsheet tools to check uploaded financial data. If an agent cannot safely control a browser or desktop, the skill falls back to just reviewing files rather than attempting automation it cannot do reliably. Safety is treated as central to the design. The skill will never ask for or handle passwords, one-time passwords, CAPTCHAs, PAN numbers, Aadhaar numbers, or full bank account credentials. It also will not pay tax, sign a declaration, upload a return, e-verify it, or submit anything without a separate, explicit confirmation from the user right before that action happens. The README reminds users that tax rules and government portal behavior change over time, so results should be checked against official Income Tax Department sources, and a qualified tax professional should be consulted when needed.