itr-wala

A skill to file an Indian income tax return from the terminal: a deterministic tax engine, both regimes, AY 2026-27

Skill

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Handles personal tax documents
  • Runs extraction and decryption scripts
All reasons and checks

karanb192/itr-wala

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/itr-wala

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .claude/skills
cp -R "$tmp/skills/itr-wala" .claude/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .github/skills
cp -R "$tmp/skills/itr-wala" .github/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .devin/skills
cp -R "$tmp/skills/itr-wala" .devin/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Formerly Windsurf.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .cline/skills
cp -R "$tmp/skills/itr-wala" .cline/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .roo/skills
cp -R "$tmp/skills/itr-wala" .roo/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add karanb192/itr-wala --skill itr-wala -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 21e730a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/karanb192/itr-wala.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/itr-wala/
git -C "$tmp" checkout 21e730a6835f5db0c2971542779a724a9b06e97d
mkdir -p .agents/skills
cp -R "$tmp/skills/itr-wala" .agents/skills/itr-wala

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 21e730a.

Text for your agent

Install as a plugin: /plugin marketplace add karanb192/itr-wala, then /plugin install itr-wala@itr-wala. Or clone the repo and run ./install.sh.

Other ways from the author
/plugin marketplace add karanb192/itr-wala
/plugin install itr-wala@itr-wala

This is third-party code. Review the repository files before installing.

What it does

itr-wala helps prepare an Indian income tax return (ITR) right from the terminal. All tax math is done by tested code, not a language model: the engine supports both tax regimes and the AY 2026-27 rates. The skill extracts data from documents such as AIS, TIS and 26AS, including decryption and archive parsing, selects the right ITR form and checks income and deductions against a checklist. It ships references on capital gains, deductions, form selection and the portal walkthrough, plus extraction scripts and tax engine tests. It installs as a skill or plugin for Claude Code, Codex and Gemini.

Who it is for. For taxpayers in India who prepare their own return and want accurate calculations by code.

Good fit when

  • You need to prepare an Indian ITR return
  • You need to extract data from AIS, TIS or 26AS
  • You need to compare the two tax regimes on your data

Not a fit when

  • You do not pay taxes in India
  • You need advice rather than calculation and return prep

Example request

Parse my AIS and 26AS documents, pick the ITR form and compute tax under both regimes

Limitations

The skill targets the Indian tax system and a specific assessment year and does not fit other countries. It prepares calculations and data, but filing goes through the official portal, and responsibility for the return stays with you. Some scripts handle sensitive tax documents, so access control matters.

How to disable. Uninstall the itr-wala plugin via /plugin or remove the skill folder from the agent directory.

Security check

  • Handles personal tax documents
  • Runs extraction and decryption scripts

README in short

The README describes itr-wala as a way to prepare an Indian tax return from the terminal without a consultant, where every calculation is done by tested code. It supports both tax regimes and AY 2026-27, extracts data from AIS, TIS and 26AS, selects the form and provides references on deductions, capital gains and the portal. It installs via install.sh, as a Claude Code or Codex plugin, or through skills.sh. It works with Claude Code, Codex and Gemini.

FAQ

Does the model do the math?

No, all tax math is done by tested code; the engine has tests and supports both regimes.

Does it file the return itself?

No, the skill prepares data and calculations, and filing goes through the official portal, with a walkthrough reference.

Editors’ pick

A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice

SkillMedium risk16.6KRepository stars
Official

Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data

MCP serverHigh risk1.8KRepository stars
Official

Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language

MCP serverHigh risk995Repository stars
Editors’ pick

An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict

SkillLow risk4Repository stars
Foxx AIitr-wala

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.