Kazakhstan Tax Assistant (kz-tax-code) for Openclaw

A dual-language tax assistant designed to provide precise answers based on the official Tax Code of the Republic of Kazakhstan.

k0zibek
v1.1.2
Mar 6, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install kz-tax-code

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install kz-tax-code using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Kazakhstan Tax Assistant (kz-tax-code)?

The kz-tax-code assistant is a highly specialized tool for Openclaw Skills that enables AI agents to query and interpret the Tax Code of the Republic of Kazakhstan (НК РК / ҚР Салық кодексі). It serves as a single source of truth for developers and accountants, retrieving data directly from local markdown versions of the legislation rather than relying on potentially outdated LLM training data. The skill supports both Russian and Kazakh languages, featuring automatic language detection to ensure accessibility across the region.

This skill is particularly valuable because it bridges the gap between raw legislative text and actionable financial insights. It handles complex tax scenarios, including various tax forms (910, 920, 700, etc.), deductions, and specific tax rates. By integrating this into your Openclaw Skills library, you ensure that your coding agent has the technical capacity to verify articles, calculate payroll taxes, and stay compliant with the latest government regulations from the KGD.

Kazakhstan Tax Assistant (kz-tax-code) Use Cases

  • Finding specific legislative articles by number or keyword (e.g., Article 363 or VAT rates).
  • Calculating individual income tax (IPN/ZhTTS) and social contributions while accounting for age-based exemptions.
  • Identifying current rates for government indicators like MRP (AIEK) and MZP (EAM).
  • Clarifying rules for simplified tax regimes, patents, and small business reporting.
  • Comparing current legislative requirements against outdated versions for historical audit purposes.

How Kazakhstan Tax Assistant (kz-tax-code) Works

  1. The assistant determines the legislative version to query, defaulting to the current tax code unless a historical period is specified.
  2. It automatically detects the language of the user query by checking for Kazakh-specific characters or explicit language flags.
  3. The skill executes a search script that prioritizes results based on article numbers, exact keyword matches, or broad topic relevancy.
  4. If the query requires external data not found in the tax code (like the Republican Budget for MRP values), it fetches the latest data from supplementary laws using integrated scripts.
  5. The agent synthesizes a response that cites the specific article, paragraph, and version name, ensuring full traceability to the legal source.

Kazakhstan Tax Assistant (kz-tax-code) Setup

This skill requires a Node.js runtime. Install it within your workspace and initialize the data sources using the following commands:

# Fetch the current budget indicators in Russian
node skills/kz-tax-code/scripts/fetch.js --doc=Z2500000065 --lang=ru --out=skills/kz-tax-code/data/budget-current-ru.md --insecure

# Search for a specific article within the tax code
node skills/kz-tax-code/scripts/search.js --article=363

Kazakhstan Tax Assistant (kz-tax-code) Data Schema & Taxonomy

The skill organizes its knowledge base using a structured file system within the data directory:

File Description
data/laws.json Mapping of external laws (Budget, Pension) with URLs and known values.
data/versions.json Metadata tracking the current and outdated versions of the Tax Code.
data/*.md Localized markdown files containing the full text of the legislation.
data/budget-current-*.md Dynamically fetched budget indicators (MRP, MZP).

Kazakhstan Tax Assistant (kz-tax-code) Advanced Features

  • Automatic language detection between Russian and Kazakh scripts.
  • Automated HTML-to-Markdown update engine that parses new legislation directly from adilet.zan.kz.
  • Context-aware payroll logic that prompts for age to determine retirement status and social contribution eligibility (OPV/OPVR).
  • Version control support to toggle between current and historical legislative editions.
  • External hints system to guide users toward egov.kz or adilet.zan.kz when data requires additional verification.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*