Agent skill

Tax

by cbrock84 in cbrock84/headcount

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new.

MITAuto-check passedBusiness, Finance & HR

Install Tax

skills CLI
$ npx skills add cbrock84/headcount --skill tax -a claude-code

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

GitHub CLI
$ gh skill install cbrock84/headcount tax --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/cbrock84/headcount.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/finance/skills/tax .claude/skills/tax && 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
GitHub stars
2k
Token cost
~974 tokens
SKILL.md length
505 words
Files
2 (incl. references)
Skills in repo
178
Repo updated
First seen
Licence
MIT

At a glance

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new.

  • Tasks that involve Tax preparation
  • SKILL.md covers Nexus: the thing that creates…, Sales tax is about what you…, The calendar is most of the… and Where it meets the rest of…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tax is an agent skill from cbrock84/headcount. Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/sources.md`).

It sits in Business, Finance & HR, covering Tax preparation. The repository describes itself as: An agent organization structured as a company — 15+ departments, 125+ skills, each independently installable, citing the standards and regulators that settle the question. Runs… The licence is MIT.

When your agent uses it

  • Tasks that involve Tax preparation

Example prompts

  • “Use the tax skill to structure the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations…”
  • “/tax”

What it can do on your machine

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

Tax loads about 974 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 91 tokens; SKILL.md has 505 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~974
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from cbrock84/headcount at commit 98d1c17, republished under its MIT licence (© cbrock84). 505 words, ~974 tokens.

Download SKILL.mdSave it as .claude/skills/tax/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
tax
description
Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

Tax

Tax obligations are created by facts — where you sell, where people work, what you sell — not by decisions anyone consciously makes. The characteristic failure is discovering an obligation years after it began, with penalties and interest attached.

This structures the question and tells you what to ask. Tax is technical, jurisdiction-specific, and changes frequently. Positions on anything material belong with a qualified tax adviser or CPA, not a checklist.

Nexus: the thing that creates obligations quietly

Nexus is the connection that gives a jurisdiction the right to tax you. It is established by activities most companies do not think of as tax events:

  • An employee working somewhere. One remote hire in a new state commonly creates payroll registration, income tax withholding, and often corporate income tax nexus.
  • Economic activity without physical presence. Since Wayfair, US states set sales-tax nexus on revenue or transaction thresholds — a few hundred thousand dollars, or a couple of hundred transactions, with the numbers differing by state.
  • Inventory held somewhere, including in a third-party fulfillment warehouse you never visit.
  • Contractors, or attending trade shows, in some jurisdictions.

Review nexus whenever you hire in a new location, cross a revenue threshold, or change how you distribute. Registering late costs more than registering early, and voluntary disclosure programs exist precisely because this is so common.

Sales tax is about what you sell, not what you charge

Taxability of software and services varies enormously by state: SaaS is taxable in some, exempt in others, and treated differently again if delivered with implementation services. The classification of your own product is a determination worth getting in writing and revisiting when packaging changes — see revenue:pricing-and-packaging, because bundling can change the answer.

Exemption certificates for tax-exempt customers must be collected and kept current. In an audit, missing certificates mean you owe the tax you did not collect.

Show full SKILL.md (199 more words)Show less

The calendar is most of the discipline

Tax failures are usually administrative, not technical: a missed registration, a late filing, an estimated payment nobody scheduled. Maintain a calendar of every obligation by jurisdiction with an owner, and treat it as part of finance:financial-reporting-and-close.

Where it meets the rest of finance

  • finance:financial-reporting-and-close — tax provision and the deferred position
  • finance:capital-allocation — after-tax returns are the only ones that matter for a decision
  • people:workforce-planning — every hire in a new jurisdiction is a tax question before it is a cost question
  • finance:revenue-recognition — book and tax treatment diverge, and the difference is itself something to track

Sources

references/sources.md in this skill lists the outside authorities that settle the questions here — what each one is authoritative for, and what you may do with it. Check them before answering on anything they cover, and cite what you used. Most are free to read and not free to reproduce; the use note on each is binding.

Never

  • Assume no obligation because there is no office in a jurisdiction.
  • Treat your product's taxability as settled across states without a determination.
  • Sell into exempt customers without current exemption certificates.
  • Take a position on a material matter without a qualified adviser.

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

Files

SKILL.md and 1 other file (references) in plugins/finance/skills/tax of cbrock84/headcount.

  • SKILL.md
  • references/sources.md

Open the folder on GitHubat commit 98d1c17

Compare with similar skills

Tax 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tax this skillcbrock84/headcount2k—~974Automated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT
Tax Filingrobbalian/claude-tax-filing174—~2.5kAutomated safety check: PassNone
India Itr CopilotLoki200399/india-itr-copilot147—~2.4kAutomated safety check: PassMIT
Consumption Taxkazukinagata/shinkoku365—~1.8kAutomated safety check: PassMIT
Beancount Optionsbex-co/beancount-io296—~3.7kAutomated 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 5 days ago
    Business, Finance & HRAuto-check passed
  • Tax Filing

    robbalian/claude-tax-filing

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

    174 GitHub stars~2.5k tokensUpdated 5 mo 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.

    296 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.

    32k GitHub starsUsed in 12 repos~2.9k tokens
    Business, Finance & HRAuto-check passed

More from cbrock84/headcount

All 178 skills in this repo
  • Agent Hierarchy

    cbrock84/headcount

    Designs orchestrator-and-subagent hierarchies for a repository — splitting agents by exclusive write surface, pairing every producer with an independent auditor, and enforcing the split with a…

    2k GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed
  • Access And Identity

    cbrock84/headcount

    Designs and audits who can reach what — authentication, authorization models, privileged access, service credentials, and joiner-mover-leaver process.

    2k GitHub stars~1.1k tokensUpdated 22 days ago
    Auto-check passed
  • Account Based Marketing

    cbrock84/headcount

    Concentrates marketing and sales effort on a named set of accounts rather than on volume — qualifying whether the model fits your economics at all, building the account list and the buying group…

    2k GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed
  • Activation

    cbrock84/headcount

    Gets new users from signup to first real value — signup flow, onboarding, time-to-value, and the early experience that determines whether someone becomes a user or a lapsed account.

    2k GitHub stars~865 tokensUpdated 22 days ago
    Auto-check passed
  • AI ML Governance

    cbrock84/headcount

    Governs models and AI systems in production — intended use, evaluation, monitoring, human oversight, documentation, and the decision to deploy or retire.

    2k GitHub stars~1k tokensUpdated 22 days ago
    Auto-check passed
  • AI Research Analyst

    cbrock84/headcount

    Produces executive-level research — market sizing, competitor mapping, trend analysis, and strategic intelligence — grounded in cited sources with the confidence in each claim made explicit.

    2k GitHub stars~916 tokensUpdated 22 days ago
    Auto-check passed

Questions about Tax

What does Tax do?

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Tax is an agent skill from cbrock84/headcount. Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new.

When should I use Tax?

Tax fits situations like: tasks that involve Tax preparation.

How do I install Tax in Claude Code?

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

How do I install Tax in Codex?

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

Can I use Tax 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 cbrock84/headcount --skill tax -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, .gemini/skills/tax, .github/skills/tax and .opencode/skills/tax in your project.

What does Tax need to run?

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

Does Tax 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 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 Tax use?

Tax 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 Tax use?

About 974 tokens (SKILL.md is roughly 3.9k 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 569 tokens, read only when the agent opens those files.

What are the alternatives to Tax?

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

Who maintains Tax?

cbrock84 (a GitHub user) maintains it in cbrock84/headcount, which has 2,016 GitHub stars. The repository holds 178 skills in this directory. The repository was last updated on September 17, 2026.

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