How do I install the Invoice skill?

Run npx skillmds@latest add dithiothreitol/invoice in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Invoice safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Invoice?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Invoice free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Invoice?

dithiothreitol (@dithiothreitol) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Invoice by dithiothreitol — Agent Skill

Name: Invoice
Author: dithiothreitol

Invoice

Wystawia fakturę VAT dla JDG — generuje DOCX (do wysyłki/druku) i XML FA(3) (do KSeF), zapisuje do rejestru SQLite i zwraca numer faktury + ścieżki plików. Użyj gdy user prosi o "wystaw fakturę", "wygeneruj fakturę", "fakturę dla...", "faktura za usługę/konsultację/miesiąc".

File contents

Wystawianie faktury VAT (JDG)

Generuje fakturę w dwóch formatach jednocześnie:

DOCX — do wysyłki mailem lub druku
XML FA(3) — wymagany format KSeF (obowiązkowy od 1.04.2026)

Zapisuje rekord do data/registry.sqlite i pliki do data/faktury/YYYY/MM/.

Wymagane dane od usera

Zanim odpalisz skrypt, upewnij się że masz:

buyer-name — nazwa nabywcy
buyer-nip — NIP (10 cyfr)
netto — kwota netto w PLN (Decimal — nie float!)

Opcjonalnie: buyer-address, buyer-email, description, period (DD.MM.YYYY-DD.MM.YYYY).

Jeśli czegoś brakuje — dopytaj usera, nie zgaduj.

Wywołanie

python3 skills/invoice/scripts/generate.py \
  --buyer-name "Firma ABC Sp. z o.o." \
  --buyer-nip "1234567890" \
  --buyer-address "ul. Przykladowa 1, 00-001 Warszawa" \
  --description "Konsultacja w zakresie AI i automatyzacji" \
  --netto 10500 \
  --period "01.04.2026-30.04.2026"

Skrypt zwraca JSON na stdout:

{
  "number": "A1/04/2026",
  "netto": "10500.00",
  "vat": "2415.00",
  "brutto": "12915.00",
  "docx_path": "data/faktury/2026/04/faktura_A1_04_2026.docx",
  "xml_path": "data/faktury/2026/04/faktura_A1_04_2026.xml",
  "payment_due": "2026-05-01",
  "status": "generated"
}

Po wygenerowaniu

Pokaż userowi numer faktury, kwotę brutto, termin płatności i ścieżki plików (jako klikalne markdown linki). Jeśli user chce od razu wysłać do KSeF — użyj skilla ksef, przekazując xml_path zwrócone tutaj.

Zmienne środowiskowe (z .env)

Skrypt sam czyta dane sprzedawcy: SELLER_NAME, SELLER_NIP, SELLER_ADDRESS, SELLER_BANK_ACCOUNT, SELLER_BANK_NAME. Jeśli skrypt zwróci błąd o braku zmiennej — powiedz userowi że trzeba uzupełnić .env.

---name: invoicedescription: Wystawia fakturę VAT dla JDG — generuje DOCX (do wysyłki/druku) i XML FA(3) (do KSeF), zapisuje do rejestru SQLite i zwraca numer faktury + ścieżki plików. Użyj gdy user prosi o "wystaw fakturę", "wygeneruj fakturę", "fakturę dla...", "faktura za usługę/konsultację/miesiąc".---# Wystawianie faktury VAT (JDG)Generuje fakturę w dwóch formatach jednocześnie:- `DOCX` — do wysyłki mailem lub druku- `XML FA(3)` — wymagany format KSeF (obowiązkowy od 1.04.2026)Zapisuje rekord do `data/registry.sqlite` i pliki do `data/faktury/YYYY/MM/`.## Wymagane dane od useraZanim odpalisz skrypt, upewnij się że masz:- **buyer-name** — nazwa nabywcy- **buyer-nip** — NIP (10 cyfr)- **netto** — kwota netto w PLN (Decimal — nie float!)Opcjonalnie: `buyer-address`, `buyer-email`, `description`, `period` (`DD.MM.YYYY-DD.MM.YYYY`).Jeśli czegoś brakuje — dopytaj usera, nie zgaduj.## Wywołanie```bashpython3 skills/invoice/scripts/generate.py \ --buyer-name "Firma ABC Sp. z o.o." \ --buyer-nip "1234567890" \ --buyer-address "ul. Przykladowa 1, 00-001 Warszawa" \ --description "Konsultacja w zakresie AI i automatyzacji" \ --netto 10500 \ --period "01.04.2026-30.04.2026"```Skrypt zwraca JSON na stdout:```json{ "number": "A1/04/2026", "netto": "10500.00", "vat": "2415.00", "brutto": "12915.00", "docx_path": "data/faktury/2026/04/faktura_A1_04_2026.docx", "xml_path": "data/faktury/2026/04/faktura_A1_04_2026.xml", "payment_due": "2026-05-01", "status": "generated"}```## Po wygenerowaniuPokaż userowi numer faktury, kwotę brutto, termin płatności i ścieżki plików (jako klikalne markdown linki).Jeśli user chce od razu wysłać do KSeF — użyj skilla `ksef`, przekazując `xml_path` zwrócone tutaj.## Zmienne środowiskowe (z .env)Skrypt sam czyta dane sprzedawcy: `SELLER_NAME`, `SELLER_NIP`, `SELLER_ADDRESS`, `SELLER_BANK_ACCOUNT`, `SELLER_BANK_NAME`. Jeśli skrypt zwróci błąd o braku zmiennej — powiedz userowi że trzeba uzupełnić `.env`.

Frequently asked questions