itr-india

Prepares and e-files Indian income tax returns ITR-1 through ITR-4 under both tax regimes.

533|84|Updated Jun 28, 2026
One-click install
npx skills add https://github.com/shivprime94/file-itr --skill itr-india-shivprime94
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: itr-india
Source: https://github.com/shivprime94/file-itr/tree/main/skills/itr-india
Command: npx skills add https://github.com/shivprime94/file-itr --skill itr-india-shivprime94

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Filing an Indian Income Tax Return correctly is error-prone: income must be reconciled against Form 16, 26AS, and AIS, the cheaper of the old and new tax regimes must be chosen by actual computation, the right ITR form must be selected, and the e-filing portal's validation defects must be resolved. This Skill guides an AI agent through that entire workflow for resident individual taxpayers. ## Core Features & Use Cases - Regime comparison and deduction discovery: Computes tax under both old and new regimes on real numbers, and proactively asks for deduction proofs (80C, 80D, HRA, home-loan interest, NPS) so no legitimate claim is missed. - Income reconciliation and form selection: Ties every income head (salary, 44ADA/44AD presumptive business, capital gains, VDA/crypto, interest) to source documents and picks the correct form among ITR-1/2/3/4 for AY 2026-27. - Independent tax computation engine: A tested Python rule engine verifies slabs, special rates (111A/112A/115BBH), set-off and carry-forward, surcharge, cess, and 234A/234B/234C interest before trusting the portal. - Portal workflow and handoff: Fills the e-filing portal schedule-by-schedule with known workarounds, then hands payment, submission, and e-verification to the user. - Use Case: A salaried user who is also a YouTube creator with listed-share STCG asks which form and regime to use; the Skill identifies ITR-3, applies 44ADA at 50% with code 16021, taxes STCG under 111A, compares both regimes, and walks them through filing. ## Quick Start Ask the agent to help you file your Indian income tax return for FY 2025-26 and provide your Form 16, 26AS, AIS, and bank statements when requested.

Frequently Asked Questions about itr-india

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between the old and new tax regime in India?

Compute total tax under both regimes on your actual numbers and pick the lower one. The new regime has wider slabs and a ₹75,000 standard deduction but removes most deductions; the old regime keeps 80C, 80D, HRA, and home-loan interest. Business filers must file Form 10-IEA before the due date to opt out of the new regime.

Which ITR form should I file for salary plus freelance income?

Salary plus freelance or creator income generally requires ITR-3, or ITR-4 if all simplified-form conditions hold (presumptive 44AD/44ADA income, total income under ₹50 lakh, no STCG, and 112A LTCG within ₹1.25 lakh for AY 2026-27). Pure salary with up to two house properties fits ITR-1.

How is crypto or VDA taxed when filing an Indian ITR?

Crypto and NFT gains are taxed at a flat 30% under section 115BBH plus 4% cess, with no loss set-off against other gains and no expense deductions. The 1% TDS under section 194S appears in 26AS and is claimed as a credit. Report gains in Schedule VDA, which rules out ITR-1.

Can I file ITR-4 with long-term capital gains under section 112A?

For AY 2026-27, ITR-4 permits aggregate LTCG under section 112A up to ₹1.25 lakh if all other eligibility conditions are met. Any short-term capital gain, 112A gains above ₹1.25 lakh, or other capital gains rule out ITR-4 and require ITR-3.

What happens if I file my Indian tax return after the due date?

A late return attracts a section 234F fee (₹5,000, or ₹1,000 if income is ₹5 lakh or less) plus 1% monthly section 234A interest on unpaid tax. Critically, capital and business losses cannot be carried forward unless the return is filed by the section 139(1) due date.

Does this skill handle non-resident or HUF tax returns?

Non-resident and RNOR returns involving DTAA relief, Form 67, and Schedule FSI/TR are out of scope. HUF filing is documented in a reference file covering the loss of 87A rebate and senior slabs, but the tested computation engine assumes an individual filer.