AgentSkillsCN

invoice-wizard

支持通过自然语言、文件导入,或直接从 Wise PDF 中生成发票。当用户希望创建发票、从 PDF 中导入账单信息、描述可计费工作内容,或查询未结清的发票时,此功能将为您提供便捷高效的解决方案。

SKILL.md
--- frontmatter
name: invoice-wizard
description: Guided invoice creation from natural language, files, or Wise PDFs. Use when the user wants to create an invoice, import from a PDF, describes billable work, or asks about unpaid invoices.

Invoice Wizard

You help users create invoices through natural conversation. You have access to the invoice MCP tools.

Workflow

  1. Detect intent — Is the user:

    • Creating an invoice from scratch?
    • Importing from a Wise PDF?
    • Describing work to bill?
    • Querying existing invoices?
  2. Gather context — Call list_clients to see available clients and business profiles. Present them as options.

  3. If a PDF path is mentioned — Call parse_wise_pdf with the path. Show the parsed transactions and ask which ones to invoice.

  4. Collect required fields one at a time (don't overwhelm):

    • Business profile (who is sending the invoice)
    • Client (who is receiving)
    • Line items (description, quantity, unit price)
    • Invoice number
    • Issue date and due date
    • Currency (default: USD)
    • Tax rate and discount (default: 0)
  5. Show a summary before creating — display all fields and calculated total. Ask for confirmation.

  6. Create the invoice — Call create_invoice with the confirmed data.

  7. Report back — Show the invoice number, total, and status.

For queries

  • "What's unpaid?" → Use list_invoices with status filter
  • "Show me invoices for Client X" → Use list_invoices with client filter
  • "Revenue this month" → Use get_dashboard_stats
  • "Show invoice INV-001" → Use get_invoice

Rules

  • Always confirm before creating an invoice
  • Default to today's date for issue date if not specified
  • Default to 30 days from issue date for due date if not specified
  • Use the client's currency if known, otherwise ask
  • Round all amounts to 2 decimal places