Skill

generate-invoice

Generate a PDF invoice from Toggl time data. Use when the user wants to create an invoice, generate a bill, or mentions invoicing a client.

npx claudepluginhub czue/agent-tools --plugin agent-tools

Tool Access

This skill is limited to using the following tools:

Bash(cd *invoice-gen*)Bash(uv run*)ReadAskUserQuestion

Preview

Generate a PDF invoice by pulling hours from Toggl and rendering to PDF. The tool lives at `/home/czue/src/personal/agent-tools/invoice-gen/`.

SKILL.md

Similar Skills

skill-lookup

159.9k

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

prompt-lookup

159.9k

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

next-compile

139.2k

Checks Next.js compilation errors using a running Turbopack dev server after code edits. Fixes actionable issues before reporting complete. Replaces `next build`.

1 file

vercel-next-js-2

Stats

Stars0

Forks0

Last CommitMar 4, 2026

Actions

View Source View Plugin View on GitHub View README

Generate Invoice

Generate a PDF invoice by pulling hours from Toggl and rendering to PDF. The tool lives at /home/czue/src/personal/agent-tools/invoice-gen/.

Arguments

$0: (optional) end date (YYYY-MM-DD)

$1: (optional) client config name (default: "peregrine")

$2: (optional) start date (YYYY-MM-DD, defaults to day after last invoice)

Workflow

Resolve the end date:

If $0 is provided, use it.
Otherwise, use AskUserQuestion to ask: "What end date for the invoice?" with options for today's date and end of last month.

Resolve the client:

If $1 is provided, use it.
Otherwise, default to peregrine.

Dry run first to confirm hours and amount:

cd /home/czue/src/personal/agent-tools/invoice-gen && uv run python generate.py --end <end_date> --client <client> --dry-run

If $2 (start date) is provided, add --start <start_date>. Show the user the hours and amount and ask for confirmation before generating.

Generate the invoice:

cd /home/czue/src/personal/agent-tools/invoice-gen && uv run python generate.py --end <end_date> --client <client>

Add --start and --description if provided by the user.

Report results: Show the output path and the invoice summary (hours, rate, amount).

CLI Options

--start: Start date. Defaults to day after last invoice end date for that client.

--end: End date (required).

--client: Client config name matching a file in invoice-gen/clients/.

--description: Work description (default: "Ongoing bolt assistant work.").

--output-dir: Output directory (default: /home/czue/Dropbox/Personal/Elodin/invoices).

--dry-run: Preview without generating.

Client Configs

Client TOML files live in invoice-gen/clients/. Each has: name, country, rate, currency, toggl_project_name, line_item_description. To add a new client, copy example.toml.

Notes

Invoice numbers auto-increment via invoice-gen/counter.json.

Last end date per client is tracked, so --start is usually not needed.

Suppress uv warnings in output (they're noisy but harmless).