What is bd-income-tax-skills AGENTS.md?

Repository guidance for a Claude Code plugin that calculates and explains personal income tax in Bangladesh. It covers work on the plugin, while a separate skill handles tax answers for users.

Use it when developing, reviewing, or committing changes to the Bangladesh personal income-tax plugin.

It gives contributors the project rules, file layout, and required checks so changes fit the repository.

How arifulislamat/bd-income-tax-skills configures Claude Code and Code

Reuse

Borrowing it

Nothing to install: this file belongs to arifulislamat/bd-income-tax-skills. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/arifulislamat/bd-income-tax-skills/master/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/arifulislamat/bd-income-tax-skills

Made for: Claude Code, Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/arifulislamat/bd-income-tax-skills/agents-md/github.svg)](https://agentmods.dev/instructions/arifulislamat/bd-income-tax-skills/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/arifulislamat/bd-income-tax-skills/agents-md"><img src="https://agentmods.dev/badge/instructions/arifulislamat/bd-income-tax-skills/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/arifulislamat/bd-income-tax-skills/agents-md"><img src="https://agentmods.dev/badge/instructions/arifulislamat/bd-income-tax-skills/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,052 This file is loaded in full into every session.

When invoked 1,052 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01052	$0.01052
Opus 5.5	$0.00421	$0.00421
Sonnet 5.5	$0.00210	$0.00210
Haiku 4.5	$0.00105	$0.00105

Measured 2mo ago against content hash 3d56a3e771b4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bd-income-tax-skills AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Guidance for AI agents (and humans) working on this repository. For the skill's own runtime behavior — how answers are computed and presented to end users — see skills/bd-income-tax/SKILL.md.

What this is

A Claude Code plugin marketplace shipping one Agent Skill, bd-income-tax, which computes and explains Bangladesh individual (personal) income tax under the Income Tax Act 2023 and the current Finance Act. Scope is individuals only — not corporate tax or VAT.

Layout

.claude-plugin/
  marketplace.json                  # marketplace manifest (source "./" — the repo is the plugin)
  plugin.json                       # plugin manifest (holds the version)
skills/bd-income-tax/               # the skill — discoverable by Claude Code AND skills.sh
  SKILL.md                          # skill instructions / runtime behavior
  scripts/tax_calc.py               # deterministic calculator — the single source of math
  references/                       # per-year data, 9-step procedure, filing rules, sources
  evals/evals.json                  # end-to-end eval cases
CHANGELOG.md  CONTRIBUTING.md  README.md  AGENTS.md  CLAUDE.md
.github/workflows/selftest.yml      # CI: runs --selftest + validates manifests
.github/workflows/release.yml       # on release publish: attaches bd-income-tax.zip

The skill lives under skills/ (not the repo root or a bd-income-tax/ subfolder) because that's a path the skills.sh CLI scans, and Claude Code discovers a plugin's skills in its skills/ directory — so one layout serves both.

Core rules (non-negotiable)

All tax math goes through scripts/tax_calc.py. Never hand-calculate; never put arithmetic in SKILL.md or the references.
Year parameters live in the PARAMS table in tax_calc.py — a yearly update touches one place. No network calls anywhere.
Cite every rate/threshold to references/sources.md. Figures not confirmed against the gazetted Act are marked ⚠️ unverified and kept out of the calculator.
Answers default to plain language (see SKILL.md §4): bottom line + monthly equivalent, a clear income year → assessment year + law line, a compact table, a what-if savings ladder, and a plain disclaimer. Match the user's language (English↔Bangla). The full numbered procedure with citations is for professionals or on request.
Use neutral example figures in docs and tests — never real personal data.

Read the full file on GitHub · 86 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 86 lines · 1,052 tokens per session scan A 3d56a3e771b4

Subscribe to this mod's changes

bd-income-tax-skills AGENTS.md is an instructions file published in the GitHub repository arifulislamat/bd-income-tax-skills (4 stars, last pushed 3mo ago), licensed MIT. It adds 1,052 tokens to every session, about $0.0042 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

agent-skills bangladesh claude-skills codex-skill income-tax tax-filing

bd-income-tax-skills AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
bd-income-tax-skills AGENTS.mdarifulislamat/bd-income-tax-skills	Instructions file	4	3mo ago	MIT	A	1,052	Claude Code, Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

bd-income-tax-skills: Instructions file for Claude Code