Agent skill

Tax Law Research

by Serein-81 in Serein-81/financial_rag

Searches current Chinese tax laws, rates and policy changes with Tavily web search, prioritizing government sources and flagging outdated or conflicting results.

No licenceAuto-check: notesLegal & Compliance

Install Tax Law Research

skills CLI
$ npx skills add Serein-81/financial_rag --skill tax-law-research -a claude-code

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

GitHub CLI
$ gh skill install Serein-81/financial_rag tax-law-research --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/Serein-81/financial_rag.git skills-src && mkdir -p .claude/skills && cp -r skills-src/rag_backend/skills/legal/tax-law-research .claude/skills/tax-law-research && 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-law-research
GitHub stars
148
Token cost
~997 tokens
SKILL.md length
326 words
Files
3 (incl. scripts, references)
Skills in repo
7
Repo updated
First seen
Licence
None found

At a glance

Searches current Chinese tax laws, rates and policy changes with Tavily web search, prioritizing government sources and flagging outdated or conflicting results.

  • Works in 5 steps: Understand the Query → Construct Search Queries → Review and Synthesize Results → …
  • Looking up current Chinese tax rates or regulations
  • SKILL.md covers Overview, Workflow, Error Handling and Gotchas
  • Runs Python scripts from its folder; needs TAVILY_API_KEY

What it does

The skill searches the web for current tax regulations, rates and policy changes using Tavily, sourced from government and authoritative legal databases. It first identifies the tax type (corporate income tax, VAT, personal income tax, stamp duty and so on), the jurisdiction and how time-sensitive the question is, asking clarifying questions when the request is vague.

It builds targeted Chinese-language search queries, such as pairing a tax type with the current year and a policy source like the State Taxation Administration, and runs them through the search_web tool or a fallback script in scripts/search_tax_law.py. Results from .gov.cn domains are prioritized, publication dates are checked, and multiple sources are cross-referenced before the findings are presented in a structured format with the topic and search date.

Error handling covers a failed search API (retry once, then tell the user), a missing TAVILY_API_KEY (fall back to general tax knowledge) and rate limiting. Gotchas noted include that Chinese tax rules change at the start of each year, local tax bureaus can add their own implementing rules, VAT rates vary by industry, and small-scale taxpayers follow different rates.

When your agent uses it

  • Looking up current Chinese tax rates or regulations
  • Checking for recent changes to a specific tax policy
  • Researching VAT or income tax compliance requirements

Example prompts

  • “What is the current VAT rate for modern services in China?”
  • “查一下2025年企业所得税最新规定。”
  • “Find the latest personal income tax special deduction standards.”

Requirements

  • A TAVILY_API_KEY configured in settings
  • The search_web MCP tool or TavilyService
  • Compatibility (from SKILL.md): Requires: TAVILY_API_KEY configured in settings Depends on: MCP cloud_tool `search_web` or TavilyService
  • Pre-approved tools (allowed-tools): Bash, Read, Write, search_web

Workflow steps

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

  1. Understand the Query
  2. Construct Search Queries
  3. Review and Synthesize Results
  4. Present Findings
  5. Handle Special Cases

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • search_web

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TAVILY_API_KEY

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

  • Compatibility

    Requires: TAVILY_API_KEY configured in settings Depends on: MCP cloud_tool `search_web` or TavilyService

    From compatibility in the SKILL.md frontmatter.

Context cost

Tax Law Research loads about 997 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 326 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~997
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, search_web

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 326 words (~997 tokens).

“Searches the web for current tax laws, regulations, rates, and policy changes using Tavily web search. Results are sourced from government and authoritative legal databases.”

— opening of SKILL.md by Serein-81
name
tax-law-research
allowed-tools
Bash, Read, Write, search_web
compatibility
Requires: TAVILY_API_KEY configured in settings Depends on: MCP cloud_tool `search_web` or TavilyService
when_to_use
Activate when the user asks about current tax rates, recent tax law changes, specific tax regulations, compliance deadlines, or any tax-related legal…
metadata.author
internal-legal-team
metadata.version
1.0
metadata.domain
legal

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts, references) in rag_backend/skills/legal/tax-law-research of Serein-81/financial_rag.

  • SKILL.md
  • references/tax_terms.md
  • scripts/search_tax_law.py

Open the folder on GitHubat commit 94b16cd

Compare with similar skills

Tax Law Research 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 Law Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tax Law Research this skillSerein-81/financial_rag148—~997Automated safety check: NotesNone
Billing And Litigation BudgetTHUYRan/Legal-Skills-Chinese874—~5kAutomated safety check: PassNone
Stakeholder Summaryanthropics/claude-for-legal9.6k2 repos~3.3kAutomated safety check: PassApache-2.0
Customizeanthropics/claude-for-legal9.6k3 repos~1.2kAutomated safety check: PassApache-2.0
Tw Legal RAGaa0101181514/tw-legal-rag328—~580Automated safety check: PassCustom licence
Design Award SearchSeanJ1ang/design-judge-skills712—~3kAutomated safety check: PassApache-2.0

Similar skills

  • Billing And Litigation Budget

    THUYRan/Legal-Skills-Chinese

    A skill your agent uses when the user needs to track or manage attorney hours, expert fees, and investigation costs; control litigation spend; or prepare timesheets or expense statements for clients.

    874 GitHub stars~5k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • Stakeholder Summary

    anthropics/claude-for-legal

    Official

    Translates a contract review into a summary the business stakeholder will actually read.

    9.6k GitHub starsUsed in 2 repos~3.3k tokens
    Legal & ComplianceAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your litigation practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 3 repos~1.2k tokens
    Legal & ComplianceAuto-check passed
  • Tw Legal RAG

    aa0101181514/tw-legal-rag

    Retrieve real Taiwan court judgments with verifiable citations before answering any question about Taiwan law or case law.

    328 GitHub stars~580 tokensUpdated yesterday
    Legal & ComplianceAuto-check passed
  • Design Award Search

    SeanJ1ang/design-judge-skills

    Find and verify award-winning designs in the same or adjacent functional category through eight explicit relevance dimensions: problem and user, core function, sensing technology, intervention…

    712 GitHub stars~3k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • China Lawyer Analyst

    CSlawyer1985/china-lawyer-analyst

    通过中国法律视角分析事件,运用成文法解释、指导案例参照、请求权基础分析等方法, 理解权利义务、评估责任风险、识别法律依据并推荐合规策略。

    196 GitHub stars~3.3k tokensUpdated 8 mo ago
    Legal & ComplianceAuto-check passed

More from Serein-81/financial_rag

  • Enterprise Tax Profile Matching

    Serein-81/financial_rag

    Builds a six-dimension profile of a company and matches it against tax policies to find applicable incentives, obligations, risks and optimization options.

    148 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Financial Data Entry

    Serein-81/financial_rag

    Guides entry of a single financial record by collecting fiscal-year figures, validating them with a script and confirming before submitting to the financial-data API.

    148 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check: notes
  • Legal Compliance Search

    Serein-81/financial_rag

    Looks up current company registration rules, industry licences and compliance obligations in China through live web search, tailored to the business profile.

    148 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check: notes
  • Policy Crawl Pipeline

    Serein-81/financial_rag

    Guides a policy notification agent through crawling government policy sources, saving them locally, matching them to enterprise profiles and generating notifications.

    148 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check: notes
  • Chinese Corporate Income Tax Check

    Serein-81/financial_rag

    Calculates China's corporate income tax with automatic preferential-rate detection for small or high-tech enterprises, then checks compliance.

    148 GitHub stars~787 tokensUpdated 4 mo ago
    Auto-check: notes
  • VAT Calculation

    Serein-81/financial_rag

    Calculates value-added tax from a tax-inclusive sales amount, VAT rate and input tax using a calculator tool, with risk checks and filing suggestions.

    148 GitHub stars~894 tokensUpdated 4 mo ago
    Auto-check: notes

Works with

Questions about Tax Law Research

What does Tax Law Research do?

Searches current Chinese tax laws, rates and policy changes with Tavily web search, prioritizing government sources and flagging outdated or conflicting results. The skill searches the web for current tax regulations, rates and policy changes using Tavily, sourced from government and authoritative legal databases. It first identifies the tax type (corporate income tax, VAT, personal income tax, stamp duty and so on), the jurisdiction and how time-sensitive the question is, asking clarifying questions when the request is vague.

When should I use Tax Law Research?

Tax Law Research fits situations like: looking up current Chinese tax rates or regulations; checking for recent changes to a specific tax policy; researching VAT or income tax compliance requirements.

How do I install Tax Law Research in Claude Code?

Run `npx skills add Serein-81/financial_rag --skill tax-law-research -a claude-code`. Or copy the skill folder (rag_backend/skills/legal/tax-law-research in Serein-81/financial_rag) into .claude/skills/tax-law-research in your project. Claude Code loads it when a task matches its description.

How do I install Tax Law Research in Codex?

Run `npx skills add Serein-81/financial_rag --skill tax-law-research -a codex`. Or copy the skill folder (rag_backend/skills/legal/tax-law-research in Serein-81/financial_rag) into .agents/skills/tax-law-research in your project. Codex loads it when a task matches its description.

Can I use Tax Law Research 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 Serein-81/financial_rag --skill tax-law-research -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-law-research, .gemini/skills/tax-law-research, .github/skills/tax-law-research and .opencode/skills/tax-law-research in your project.

What does Tax Law Research need to run?

Going by SKILL.md and its folder, Tax Law Research needs Python for the scripts in its folder and credentials named TAVILY_API_KEY. Our summary lists: A TAVILY_API_KEY configured in settings; The search_web MCP tool or TavilyService. Its frontmatter pre-approves these tools: Bash, Read, Write, search_web. Compatibility (from SKILL.md): Requires: TAVILY_API_KEY configured in settings Depends on: MCP cloud_tool `search_web` or TavilyService .

Does Tax Law Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tax Law Research safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. 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 Law Research use?

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

How many tokens does Tax Law Research use?

About 997 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 325 tokens, read only when the agent opens those files.

What are the alternatives to Tax Law Research?

Skills that share tags, products or a category with Tax Law Research: Billing And Litigation Budget (THUYRan/Legal-Skills-Chinese, 874 stars), Stakeholder Summary (anthropics/claude-for-legal, 9.6k stars), Customize (anthropics/claude-for-legal, 9.6k stars) and Tw Legal RAG (aa0101181514/tw-legal-rag, 328 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tax Law Research?

Serein-81 (a GitHub user) maintains it in Serein-81/financial_rag, which has 148 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on June 5, 2026.

Source: Serein-81/financial_rag on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.