whatisgithub

What is itr-prep-skill?

nidheeshjain/itr-prep-skill — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 3/5LicenseSetup · easy

In one sentence

A Claude Code skill that turns your Indian tax documents into a fully reconciled, portal-ready data file for filing ITR-1 through ITR-4.

Mindmap

mindmap
  root((itr-prep-skill))
    What it does
      Reads tax documents
      Compares tax regimes
      Produces filing data pack
    Tech stack
      Python
      Claude Code skill
    Use cases
      Prepare Indian income tax return
      Compare old vs new regime
      Reconcile AIS and 26AS
    Audience
      Individual taxpayers in India
      Tax preparers
    Boundaries
      Stops at data pack
      Hands off to filing agent
      Escalates complex cases to CA

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn Form 16, AIS, and Form 26AS documents into a reconciled tax computation.

USE CASE 2

Compare the old and new tax regimes with real calculations to pick the better one.

USE CASE 3

Calculate capital gains tax across equity, property, gold, and cryptocurrency.

USE CASE 4

Generate a structured data pack ready to hand off to a filing agent.

What is it built with?

PythonClaude Code

How does it compare?

nidheeshjain/itr-prep-skill1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity3/52/51/5
Audiencegeneralvibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires a Python package for decrypting the AIS document, plus a browser-capable agent to actually file.

So what is it?

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.

Copy-paste prompts

Prompt 1
Help me prepare my Indian income tax return using my Form 16 and AIS statement with this skill.
Prompt 2
Explain how this skill compares the old and new tax regimes to pick the better one for me.
Prompt 3
Walk me through installing this skill into my Claude Code skills folder.
Prompt 4
Show me how the generated data pack gets handed off to a browser agent for filing.

Frequently asked questions

What is itr-prep-skill?

A Claude Code skill that turns your Indian tax documents into a fully reconciled, portal-ready data file for filing ITR-1 through ITR-4.

What language is itr-prep-skill written in?

Mainly Python. The stack also includes Python, Claude Code.

How hard is itr-prep-skill to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is itr-prep-skill for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.