Agent skill

Tax Filing

by robbalian in robbalian/claude-tax-filing

Prepare and fill federal and state tax return PDF forms. An agent skill from robbalian/claude-tax-filing.

No licenceAuto-check passedBusiness, Finance & HR

Install Tax Filing

skills CLI
$ npx skills add robbalian/claude-tax-filing --skill tax-filing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install robbalian/claude-tax-filing tax-filing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/robbalian/claude-tax-filing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tax-filing .claude/skills/tax-filing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tax-filing
GitHub stars
174
Token cost
~2.5k tokens
SKILL.md length
1,135 words
Files
4 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Prepare and fill federal and state tax return PDF forms. An agent skill from robbalian/claude-tax-filing.

  • Works in 11 steps: Gather Source Documents → Confirm Filing Details — MANDATORY → Look Up Year-Specific Values → …
  • Tasks that involve Tax preparation
  • SKILL.md covers Folder Structure, Context Budget Rules, Workflow and Key Gotchas
  • Runs Python scripts from its folder; calls python and python3; reaches irs.gov

What it does

Tax Filing is an agent skill from robbalian/claude-tax-filing. Prepare and fill federal and state tax return PDF forms

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/discover_fields.py`, `scripts/fill_forms.py` and `scripts/verify_filled.py`).

It sits in Business, Finance & HR, covering Tax preparation and PDF.

When your agent uses it

  • Tasks that involve Tax preparation
  • Tasks that involve PDF

Example prompts

  • “/tax-filing”

Requirements

  • Python 3

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Gather Source Documents
  2. Confirm Filing Details — MANDATORY
  3. Look Up Year-Specific Values
  4. Compute Federal Return
  5. Compute Capital Gains (if applicable)
  6. Compute State Return (CA Form 540)
  7. Download Blank PDF Forms
  8. Discover Field Names & Fill Forms
  9. Verify
  10. Present Results
  11. MFJ vs Single Comparison (if Married Filing Jointly)

What it can do on your machine

Read from SKILL.md and the folder at commit 42e371a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • irs.gov

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tax Filing loads about 2.5k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 1,135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,135 words (~2,488 tokens).

“Prepare federal and state income tax returns: read source documents, compute taxes, fill official PDF forms.”

— opening of SKILL.md by robbalian
name
tax-filing
user_invocable
true
triggers
do my taxes, prepare tax return, fill tax forms, file taxes, tax preparation

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in skills/tax-filing of robbalian/claude-tax-filing.

  • SKILL.md
  • scripts/discover_fields.py
  • scripts/fill_forms.py
  • scripts/verify_filled.py

Open the folder on GitHubat commit 42e371a

Compare with similar skills

Tax Filing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tax Filing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tax Filing this skillrobbalian/claude-tax-filing174—~2.5kAutomated safety check: PassNone
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT
India Itr CopilotLoki200399/india-itr-copilot147—~2.4kAutomated safety check: PassMIT
Consumption Taxkazukinagata/shinkoku365—~1.8kAutomated safety check: PassMIT
Beancount Optionsbex-co/beancount-io297—~3.7kAutomated safety check: PassMIT
Invoice Organizerdavila7/claude-code-templates33k12 repos~2.9kAutomated safety check: PassMIT

Similar skills

  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed
  • India Itr Copilot

    Loki200399/india-itr-copilot

    Documents-first copilot for preparing Indian Income Tax Returns (ITR-1/2/3/4, any assessment year).

    147 GitHub stars~2.4k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Consumption Tax

    kazukinagata/shinkoku

    This skill should be used when the user needs to calculate consumption tax (消費税) or determine their tax method (2割特例, 簡易課税, or 本則課税).

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Beancount Options

    bex-co/beancount-io

    Record a described options trade or lifecycle event as validated Beancount transactions through bea, after review and confirmation.

    297 GitHub stars~3.7k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Invoice Organizer

    davila7/claude-code-templates

    Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.

    33k GitHub starsUsed in 12 repos~2.9k tokens
    Business, Finance & HRAuto-check passed
  • Kanchi Dividend Us Tax Accounting

    tradermonty/claude-trading-skills

    Provide US dividend tax and account-location workflow for Kanchi-style income portfolios.

    3k GitHub starsUsed in 1 repo~1.1k tokens
    Business, Finance & HRAuto-check passed

Questions about Tax Filing

What does Tax Filing do?

Prepare and fill federal and state tax return PDF forms. An agent skill from robbalian/claude-tax-filing. Tax Filing is an agent skill from robbalian/claude-tax-filing.

When should I use Tax Filing?

Tax Filing fits situations like: tasks that involve Tax preparation; tasks that involve PDF.

How do I install Tax Filing in Claude Code?

Run `npx skills add robbalian/claude-tax-filing --skill tax-filing -a claude-code`. Or copy the skill folder (skills/tax-filing in robbalian/claude-tax-filing) into .claude/skills/tax-filing in your project. Claude Code loads it when a task matches its description.

How do I install Tax Filing in Codex?

Run `npx skills add robbalian/claude-tax-filing --skill tax-filing -a codex`. Or copy the skill folder (skills/tax-filing in robbalian/claude-tax-filing) into .agents/skills/tax-filing in your project. Codex loads it when a task matches its description.

Can I use Tax Filing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add robbalian/claude-tax-filing --skill tax-filing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tax-filing, .gemini/skills/tax-filing, .github/skills/tax-filing and .opencode/skills/tax-filing in your project.

What does Tax Filing need to run?

Going by SKILL.md and its folder, Tax Filing needs Python for the scripts in its folder and the command-line tools its instructions call (python and python3). Our summary lists: Python 3.

Does Tax Filing access the network?

SKILL.md names 1 domain. In commands or code: irs.gov; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Tax Filing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tax Filing use?

No licence was found for Tax Filing or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Tax Filing use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tax Filing?

Skills that share tags, products or a category with Tax Filing: Itr Wala (karanb192/itr-wala, 871 stars), India Itr Copilot (Loki200399/india-itr-copilot, 147 stars), Consumption Tax (kazukinagata/shinkoku, 365 stars) and Beancount Options (bex-co/beancount-io, 297 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tax Filing?

robbalian (a GitHub user) maintains it in robbalian/claude-tax-filing, which has 174 GitHub stars. The repository was last updated on April 14, 2026.

Source: robbalian/claude-tax-filing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.