Agent skill

Token Receipt

by Hchen1218 in Hchen1218/token-receipt

A skill your agent uses when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper…

No licenceAuto-check passedDocuments & Office

Install Token Receipt

skills CLI
$ npx skills add Hchen1218/token-receipt --skill token-receipt -a claude-code

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

GitHub CLI
$ gh skill install Hchen1218/token-receipt token-receipt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
token-receipt
GitHub stars
126
Token cost
~2.1k tokens
SKILL.md length
460 words
Files
35 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper…

  • Works in 11 steps: 默认行为应该是“按当前软件取数” → 如果当前运行环境识别不出软件,而且本机同时存在多套日志,必须显式传… → 默认使用最新 token_count 事件里的… → …
  • The user wants to view AI conversation token usage as a receipt
  • SKILL.md covers 用户怎么触发, 当前产品方向, 快速执行 and 调用模式, plus 8 more sections
  • Runs Python scripts from its folder; calls python3 and claude

What it does

Token Receipt is an agent skill from Hchen1218/token-receipt. Use when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper artifact. Always consider this skill for Chinese prompts like 查看本次对话 Token 消耗, 生成 token 小票, 对话发票, AI 用量账单, 把这次对话打成小票, 看看这轮 token 消耗, or any request to make token/context usage visually shareable.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 39 other files, including scripts and reference files (for example `CHANGELOG.md`, `README.md` and `README.zh-CN.md`).

It sits in Documents & Office, covering Forms and invoices. The repository describes itself as: Turn AI token usage into a receipt with a punchline.

When your agent uses it

  • The user wants to view AI conversation token usage as a receipt
  • Creative monospace thermal-paper artifact

Example prompts

  • “/token-receipt”

Requirements

  • Python 3

Workflow steps

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

  1. 默认行为应该是“按当前软件取数”
  2. 如果当前运行环境识别不出软件,而且本机同时存在多套日志,必须显式传 --agent-tool codex、--agent-tool claude-code、--agent-tool kimi-code 或 --agent-tool opencode;不要猜。
  3. 默认使用最新 token_count 事件里的 last_token_usage,即“最新一轮小票”。
  4. 如果用户要求累计账单,使用 --scope session 读取 total_token_usage。
  5. 供应商优先读 session_meta.payload.model_provider;模型名先读 session_meta.payload.model*,若没有再回退读 turn_context.model;都没有时再要求调用者传 --model,否则小票显示 MODEL…
  6. 价格只按 references/pricing.json 的官方价格表估算。匹配不到模型时显示 PRICE: UNMAPPED,不要自己编金额。
  7. 价格表按模型条目保留币种;美元模型显示 USD ESTIMATE,人民币模型显示 CNY ESTIMATE。GLM 使用已标注的百炼 CNY 公开价格,MiMo 使用 OpenRouter 路由价格;不要把平台价伪装成厂商直连账单。
  8. 主标题使用 THANK YOU FOR CODING WITH ...,让它更像真实品牌小票;不要在票面再放 DATA: SNAPSHOT。
  9. 顶部 logo 按软件决定:Codex、Claude Code、Trae、Kimi Code、OpenCode 各有对应块标;感谢语仍按模型/供应商(Claude/GPT/Qwen…),不要把宿主 logo 当成模型名。
  10. 用户切换语言时
  11. 运行 --show-fields 可以查看当前日志里真实可读的字段。更详细说明见 references/available-fields.md。

What it can do on your machine

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

    Ships 4 files in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • claude

    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

Token Receipt loads about 2.1k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 460 words of instructions outside code blocks.

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

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); 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 460 words (~2,068 tokens).

“把本次 AI 对话的 Token 消耗做成一张可截图传播的 monospace 热敏纸小票。视觉优先级高于报表完整性,但数据口径必须诚实:真实日志优先,官方价格估算其次,缺失信息要明确标注。”

— opening of SKILL.md by Hchen1218
name
token-receipt

Read the full SKILL.md on GitHub

Files

SKILL.md and 34 other files (scripts, references) in the repository root of Hchen1218/token-receipt.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • README.md
  • README.zh-CN.md
  • agents/openai.yaml
  • evals/evals.json
  • examples/visual-acceptance.md
  • references/available-fields.md
  • references/pricing.json
  • references/receipt-style.md
  • references/trigger-phrases.md
  • scripts/claude_session_end_hook.py
  • scripts/install_claude_auto_trigger.py
  • scripts/token_receipt.py
  • scripts/uninstall_claude_auto_trigger.py
  • … and 19 more

Open the folder on GitHubat commit 4894e9a

Compare with similar skills

Token Receipt 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.

Token Receipt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Token Receipt this skillHchen1218/token-receipt126—~2.1kAutomated safety check: PassNone
Form Fillingplatonai/Browser41.2k—~1.1kAutomated safety check: PassApache-2.0
Code2mediatsingliuwin/autoclaw283—~956Automated safety check: PassMIT
Invoice Makertsingliuwin/autoclaw283—~612Automated safety check: PassMIT
Invoice Generatorluzhenqian/ai-coding-lab152—~955Automated safety check: PassNone
Paginated Reportdata-goblin/power-bi-agentic-development1k—~3.5kAutomated safety check: PassGPL-3.0

Similar skills

  • Form Filling

    platonai/Browser4

    Automatically fills web forms using provided field data and can optionally submit the form.

    1.2k GitHub stars~1.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Code2media

    tsingliuwin/autoclaw

    Universal media renderer with no fixed template — any custom layout, size or style becomes pixel-perfect images (PNG/JPEG/WebP), vector SVG, paged PDFs or animations (WebP/GIF).

    283 GitHub stars~956 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Invoice Maker

    tsingliuwin/autoclaw

    开发票/生成发票/报价单/收据/采购单/对账单/账单/付款通知 — formal business documents as paged PDFs with proper tables, right-aligned amounts, tax lines, repeating headers and page-number footers.

    283 GitHub stars~612 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Invoice Generator

    luzhenqian/ai-coding-lab

    从 Excel 时间表或手动输入生成专业发票。当用户提到生成发票、创建账单、invoice、billing、开发票、时间表转发票、账单生成时使用此技能。

    152 GitHub stars~955 tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Paginated Report

    data-goblin/power-bi-agentic-development

    Author, validate, publish, and test Power BI paginated reports in the RDL format.

    1k GitHub stars~3.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Weak Agent Test

    kklimuk/docx-cli

    Run the weak-agent adversarial test harness against docx-cli.

    216 GitHub stars~6.1k tokensUpdated 13 days ago
    Documents & OfficeAuto-check: notes

Questions about Token Receipt

What does Token Receipt do?

A skill your agent uses when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper…. Token Receipt is an agent skill from Hchen1218/token-receipt. Use when the user wants to view AI conversation token usage as a receipt, invoice, checkout slip, token bill, usage receipt, cost snapshot, or creative monospace thermal-paper artifact.

When should I use Token Receipt?

Token Receipt fits situations like: the user wants to view AI conversation token usage as a receipt; creative monospace thermal-paper artifact.

How do I install Token Receipt in Claude Code?

Run `npx skills add Hchen1218/token-receipt --skill token-receipt -a claude-code`. Or copy the skill folder (the Hchen1218/token-receipt repository) into .claude/skills/token-receipt in your project. Claude Code loads it when a task matches its description.

How do I install Token Receipt in Codex?

Run `npx skills add Hchen1218/token-receipt --skill token-receipt -a codex`. Or copy the skill folder (the Hchen1218/token-receipt repository) into .agents/skills/token-receipt in your project. Codex loads it when a task matches its description.

Can I use Token Receipt 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 Hchen1218/token-receipt --skill token-receipt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/token-receipt, .gemini/skills/token-receipt, .github/skills/token-receipt and .opencode/skills/token-receipt in your project.

What does Token Receipt need to run?

Going by SKILL.md and its folder, Token Receipt needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and claude). Our summary lists: Python 3.

Does Token Receipt 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 Token Receipt 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Token Receipt use?

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

How many tokens does Token Receipt use?

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

What are the alternatives to Token Receipt?

Skills that share tags, products or a category with Token Receipt: Form Filling (platonai/Browser4, 1.2k stars), Code2media (tsingliuwin/autoclaw, 283 stars), Invoice Maker (tsingliuwin/autoclaw, 283 stars) and Invoice Generator (luzhenqian/ai-coding-lab, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Token Receipt?

Hchen1218 (a GitHub user) maintains it in Hchen1218/token-receipt, which has 126 GitHub stars. The repository was last updated on June 5, 2026.

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