← 返回 Skills 市场
atum246

Invoice Agent

作者 Atum246 · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
91
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install invoice-agent
功能描述
Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payme...
使用说明 (SKILL.md)

Invoice Agent 💰

Professional invoice management entirely from the command line. All data stored locally at ~/.invoice-agent/data.json.

Setup (one-time)

# Configure your business defaults
python3 SKILL_DIR/scripts/invoice.py config \
  --business-name "Your Business" \
  --business-email "[email protected]" \
  --currency USD \
  --tax-rate 0

Quick Workflows

Create an Invoice (natural language → invoice)

User: "Create an invoice for Acme Corp for website design $2500 and SEO setup $500, due in 30 days"
python3 SKILL_DIR/scripts/invoice.py create \
  --client "Acme Corp" \
  --items "Website Design|1|2500" "SEO Setup|1|500" \
  --due-days 30

Generate Professional HTML Invoice

# Export first
python3 SKILL_DIR/scripts/invoice.py export --id INV-XXX
# Generate HTML
python3 SKILL_DIR/scripts/generate_invoice.py ~/.invoice-agent/invoices/INV-XXX.json invoice.html

Check Overdue Payments & Send Reminders

python3 SKILL_DIR/scripts/invoice.py overdue
python3 SKILL_DIR/scripts/reminders.py

Financial Dashboard

python3 SKILL_DIR/scripts/invoice.py summary --period month

Key Commands

Command Purpose
create --client NAME --items "desc|qty|price" New invoice
list [--status STATUS] List/filter invoices
show --id INV-XXX Full invoice details
update --id INV-XXX --status paid Mark as paid/sent
summary --period month Revenue report
overdue List overdue invoices
reminders.py Generate reminder emails
generate_invoice.py HTML invoice from JSON
config [--business-name NAME ...] Set defaults

Item Format

Items use pipe-separated format: "Description|Quantity|UnitPrice"

  • "Website Design|1|2500" → 1 × $2,500 = $2,500
  • "Hosting|3|29.99" → 3 × $29.99 = $89.97
  • "Consulting|2|150" → 2 × $150 = $300

Reminder Escalation

Auto-escalation based on days overdue:

  • 1-7 days: Gentle/friendly tone
  • 8-21 days: Firm/professional tone
  • 22+ days: Final notice with legal warning

References

  • Full command reference: see references/guide.md
  • HTML template: edit assets/invoice-template.html for custom branding
  • Customize brand color: change BRAND_COLOR_DEFAULT in scripts/generate_invoice.py
安全使用建议
This package appears to be a self-contained, local invoice CLI. Before installing: (1) review and back up any existing ~/.invoice-agent data since the scripts will create/write there; (2) note that the HTML generator directly injects invoice fields into the template without escaping — avoid including untrusted HTML in invoice fields or sanitize/escape fields before opening generated HTML in a browser; (3) reminders.py only formats messages and prints them — it does not send emails (so no hidden exfiltration), but if you modify it to send messages, inspect any added network code carefully; (4) the skill is proprietary and has no homepage/author details in metadata — if provenance matters to you, ask the publisher for source/audit info or run it in a restricted environment first.
功能分析
Type: OpenClaw Skill Name: invoice-agent Version: 1.0.1 The invoice-agent skill is a legitimate local utility for managing business invoices and payment tracking. The core logic in scripts/invoice.py and scripts/generate_invoice.py handles CRUD operations and HTML generation using standard Python libraries without any network requests, external dependencies, or suspicious system calls. All data is stored locally in the user's home directory (~/.invoice-agent/), and the instructions in SKILL.md are strictly aligned with the stated purpose of the tool.
能力标签
cryptocan-make-purchases
能力评估
Purpose & Capability
Name/description (invoice creation, reminders, HTML generation, local storage) match the included scripts and SKILL.md. The scripts read/write only under ~/.invoice-agent and implement the advertised features (create/list/update/export/reminders/HTML generation). No unrelated services, binaries, or credentials are requested.
Instruction Scope
Runtime instructions tell the agent to run the included CLI scripts and to use SKILL_DIR; they operate only on local files under ~/.invoice-agent. One implementation note: the HTML generation inserts invoice fields into the template without escaping, so if invoice fields contain HTML/script content it could produce an HTML injection/XSS when opened in a browser. The reminders script generates email text but does not send emails or contact external endpoints.
Install Mechanism
No install spec is provided (instruction-only skill). All source files are included in the bundle; there are no downloads, package installs, or external install URLs to evaluate.
Credentials
No environment variables, API keys, or external credentials are required. The requested filesystem access (creating ~/.invoice-agent and writing JSON/invoice files) is proportionate to the stated purpose.
Persistence & Privilege
always is false and the skill does not request elevated or persistent platform privileges. It does not modify other skills or system-wide agent settings and only writes to its own data directory.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install invoice-agent
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /invoice-agent 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Fixed license to proprietary. Single-user license via ClawHub marketplace.
v1.0.0
Initial release of invoice-agent — command-line invoice and payment management. - Create and manage invoices using natural language. - Supports multi-currency, tax calculations, and local data storage (no cloud/API). - Tracks payment status, overdue invoices, and automates reminder escalation. - Generates professional HTML invoices from JSON data. - Provides financial summaries and revenue reports for freelancers, agencies, and small businesses.
元数据
Slug invoice-agent
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Invoice Agent 是什么?

Professional invoice and payment management skill. Create, track, and manage invoices with natural language. Supports multi-currency, tax calculations, payme... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 91 次。

如何安装 Invoice Agent?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install invoice-agent」即可一键安装,无需额外配置。

Invoice Agent 是免费的吗?

是的,Invoice Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Invoice Agent 支持哪些平台?

Invoice Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Invoice Agent?

由 Atum246(@atum246)开发并维护,当前版本 v1.0.1。

💬 留言讨论