Agent skill

Vat Summary

by WellApp-ai in WellApp-ai/Well

Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger.

MITAuto-check passedBusiness, Finance & HR

Install Vat Summary

skills CLI
$ npx skills add WellApp-ai/Well --skill vat-summary -a claude-code

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

GitHub CLI
$ gh skill install WellApp-ai/Well vat-summary --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/WellApp-ai/Well.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/well/skills/vat-summary .claude/skills/vat-summary && 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
vat-summary
GitHub stars
345
Token cost
~535 tokens
SKILL.md length
267 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger.

  • Works in 5 steps: Discover the schema first (see… → Output VAT (collected on sales) — from… → Input VAT (paid on purchases) — from… → …
  • The user asks for a VAT return
  • SKILL.md covers Build it from the posted…, Rules — conservative by design and Present it
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Vat Summary is an agent skill from WellApp-ai/Well. Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger. Use when the user asks for a VAT return, VAT summary, sales tax owed, output vs input VAT, or tax declaration figures for a period.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Tax preparation and Forms and invoices. The repository describes itself as: No more Sundays on Finance. We build the infrastructure that retrieves, processes, and routes your financial and business data to your FinOps stack, so founders can ship, not… The licence is MIT.

When your agent uses it

  • The user asks for a VAT return
  • Output vs input VAT
  • Tax declaration figures for a period

Example prompts

  • “/vat-summary”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Discover the schema first (see well:querying-well-data).
  2. Output VAT (collected on sales) — from issued invoices / invoice_items and their tax_rates, or the corresponding VAT ledger_accounts /…
  3. Input VAT (paid on purchases) — from received invoices / invoice_items + tax_rates, or the input-VAT ledger accounts.
  4. Net VAT due = output VAT − recoverable input VAT, per the period's date filter.
  5. By rate and jurisdiction — break the totals down by VAT rate and, for multi-jurisdiction workspaces, by jurisdiction. Read the rate from…

What it can do on your machine

Read from SKILL.md and the folder at commit c740217. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Vat Summary loads about 535 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 267 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from WellApp-ai/Well at commit c740217, republished under its MIT licence (© WellApp-ai). 267 words, ~535 tokens.

Download SKILL.mdSave it as .claude/skills/vat-summary/SKILL.md (or your agent's skills folder).
name
vat-summary
description
Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger. Use when the user asks for a VAT return, VAT summary, sales tax owed, output vs input VAT, or tax declaration figures for a period.

VAT summary from Well

A VAT return is a byproduct of closed books, not a separate project. If the ledger is posted and correct, the figures already exist — the work is presentation. Work backward from the filing deadline and forward from the posted ledger, and surface uncertainty rather than reporting a number you're not sure of.

Build it from the posted ledger + tax rates

  1. Discover the schema first (see well:querying-well-data).
  2. Output VAT (collected on sales) — from issued invoices / invoice_items and their tax_rates, or the corresponding VAT ledger_accounts / journal_entries for the period. Group by rate (standard / reduced / zero / exempt).
  3. Input VAT (paid on purchases) — from received invoices / invoice_items + tax_rates, or the input-VAT ledger accounts.
  4. Net VAT due = output VAT − recoverable input VAT, per the period's date filter.
  5. By rate and jurisdiction — break the totals down by VAT rate and, for multi-jurisdiction workspaces, by jurisdiction. Read the rate from the data (tax_rates), don't assume it.

Rules — conservative by design

  • "The books are not closed yet." If the period's journal_entries are still DRAFT / unposted, say so before producing a final figure — declarations fall out of closed books. Offer a provisional figure clearly labelled as such.
  • Surface uncertainty, don't file it. Where a rate, exemption, or jurisdiction treatment is ambiguous, flag it for human review rather than guessing.
  • Read rates and jurisdictions from tax_rates / the data; never hardcode a percentage.
  • Don't sum across currencies without converting (exchange_rates).

Present it

Output VAT (by rate) → total; Input VAT (by rate) → total; Net VAT due; the period and jurisdiction; a books-closed/draft status line; and any flagged uncertainties for review.

© WellApp-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/well/skills/vat-summary of WellApp-ai/Well.

Open the folder on GitHubat commit c740217

Compare with similar skills

Vat Summary 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.

Vat Summary compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vat Summary this skillWellApp-ai/Well345—~535Automated safety check: PassMIT
Invoice Organizerdavila7/claude-code-templates33k12 repos~2.9kAutomated safety check: PassMIT
Tax Invoice Credit Contextkazukinagata/shinkoku365—~254Automated safety check: PassMIT
Pp Quentlimvanhorn/printing-press-library2.1k—~7.8kAutomated safety check: NotesApache-2.0
Tw Einvoice Guideasgard-ai-platform/skills242—~1.4kAutomated safety check: PassMIT
Kiwi ReceiptsLeoYeAI/openclaw-master-skills2.2k—~5.2kAutomated safety check: PassMIT

Similar skills

  • 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
  • Tax Invoice Credit Context

    kazukinagata/shinkoku

    Background context for invoice-system input tax credit rules (仕入税額控除) in the shinkoku tax filing plugin.

    365 GitHub stars~254 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Pp Quentli

    mvanhorn/printing-press-library

    Every Quentli payments, invoicing, and SAT tax-billing endpoint, plus offline collection, reconciliation, and at-risk-subscription intelligence no other Quentli tool has.

    2.1k GitHub stars~7.8k tokensUpdated today
    Business, Finance & HRAuto-check: notes
  • Tw Einvoice Guide

    asgard-ai-platform/skills

    Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation.

    242 GitHub stars~1.4k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Kiwi Receipts

    LeoYeAI/openclaw-master-skills

    NZ tax assistant for sole traders. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • 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

More from WellApp-ai/Well

All 36 skills in this repo
  • Tech Divergence

    WellApp-ai/Well

    Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

    345 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 3 days ago
    Auto-check passed
  • Autonomous Loop

    WellApp-ai/Well

    Iterate until success or limit, composing existing skills with Jidoka integration

    345 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed
  • Balance Sheet

    WellApp-ai/Well

    Build a balance sheet (bilan) from a Well workspace. An agent skill from WellApp-ai/Well.

    345 GitHub stars~534 tokensUpdated 3 days ago
    Auto-check passed
  • Bpmn Workflow

    WellApp-ai/Well

    Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

    345 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • Cash Flow Forecast

    WellApp-ai/Well

    Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions.

    345 GitHub stars~567 tokensUpdated 3 days ago
    Auto-check passed

Questions about Vat Summary

What does Vat Summary do?

Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger. Vat Summary is an agent skill from WellApp-ai/Well. Produce a VAT / sales-tax summary for a period from a Well workspace's posted ledger.

When should I use Vat Summary?

Vat Summary fits situations like: the user asks for a VAT return; output vs input VAT; tax declaration figures for a period.

How do I install Vat Summary in Claude Code?

Run `npx skills add WellApp-ai/Well --skill vat-summary -a claude-code`. Or copy the skill folder (plugins/well/skills/vat-summary in WellApp-ai/Well) into .claude/skills/vat-summary in your project. Claude Code loads it when a task matches its description.

How do I install Vat Summary in Codex?

Run `npx skills add WellApp-ai/Well --skill vat-summary -a codex`. Or copy the skill folder (plugins/well/skills/vat-summary in WellApp-ai/Well) into .agents/skills/vat-summary in your project. Codex loads it when a task matches its description.

Can I use Vat Summary 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 WellApp-ai/Well --skill vat-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vat-summary, .gemini/skills/vat-summary, .github/skills/vat-summary and .opencode/skills/vat-summary in your project.

What does Vat Summary need to run?

SKILL.md names no scripts, command-line tools or credentials: Vat Summary is instructions for the agent only.

Does Vat Summary 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 Vat Summary 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. Review the folder before installing.

What licence does Vat Summary use?

Vat Summary is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vat Summary use?

About 535 tokens (SKILL.md is roughly 2.1k 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 Vat Summary?

Skills that share tags, products or a category with Vat Summary: Invoice Organizer (davila7/claude-code-templates, 33k stars), Tax Invoice Credit Context (kazukinagata/shinkoku, 365 stars), Pp Quentli (mvanhorn/printing-press-library, 2.1k stars) and Tw Einvoice Guide (asgard-ai-platform/skills, 242 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vat Summary?

WellApp-ai (a GitHub organization) maintains it in WellApp-ai/Well, which has 345 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 7, 2026.

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