nidheeshjain/itr-prep-skill

itr-prep-skill is a skill for Claude Code, an AI coding assistant, that helps someone prepare their Indian Income Tax Return. It is built for the Indian tax forms known as ITR-1, ITR-2, ITR-3, and ITR-4. Instead of you manually reading through your tax documents and filling in numbers, you give it your Form 16 from your employer, your AIS and Form 26AS statements from the tax department, your broker's profit and loss statement, and your payslips, and it works through them to build a complete, checked tax computation. It figures out which of the two tax forms and which of the two tax regimes, old or new, actually results in the better outcome for you, by doing the real calculation rather than guessing. It can handle income from multiple employers in the same year, capital gains from shares, debt funds, property, gold, or cryptocurrency, income from trading, whether an audit is required, and carrying forward or setting off losses from previous years. It can also handle foreign assets and foreign income, and works out interest charges for late or short payment of tax. It checks all these numbers against your AIS and Form 26AS records to make sure nothing was missed or mismatched. Rather than filling in the tax portal itself, the skill's job stops at producing a structured file, called a data pack, that lays out every number and where it should go. This file is meant to be handed to a second AI agent, one with the ability to browse the web, which uses the data pack to actually fill out the schedules on the government's e-filing website, while you handle logging in and clicking submit yourself. The project is explicit that this is a careful helper, not a replacement for a chartered accountant, and it hands off harder cases such as audits or contested notices to a professional. To install it, you clone the repository into your Claude Code skills folder and install a Python package needed for decrypting one of the tax documents.