How do I install the Contracts skill?

Run npx skillmds@latest add dithiothreitol/contracts 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 Contracts 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 Contracts?

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 Contracts free to use?

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

Who published Contracts?

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

Contracts by dithiothreitol — Agent Skill

Name: Contracts
Author: dithiothreitol

Contracts

Cykliczne kontrakty JDG — automatyczne wystawianie faktur miesięcznych, oznaczanie płatności, import CSV z banku. Użyj gdy user pyta "faktury automatyczne", "kontrakt cykliczny", "auto-fakturowanie", "subskrypcja klienta", "powtarzające się faktury", "oznacz jako zapłacone", "import wyciągu", "CSV bank", "które faktury nie zostały zapłacone".

File contents

Cykliczne kontrakty + śledzenie płatności

1. Auto-fakturowanie

# Uruchom na dziś (z crona lub ręcznie)
python3 skills/contracts/scripts/run_contracts.py

# Symulacja na konkretny dzień
python3 skills/contracts/scripts/run_contracts.py --date 2026-04-30

2. Oznacz fakturę jako zapłaconą

python3 skills/contracts/scripts/mark_paid.py "A1/04/2026"
python3 skills/contracts/scripts/mark_paid.py "A1/04/2026" --date 2026-04-25

3. Import CSV z banku

# Podgląd dopasowań (bez zapisu)
python3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv

# Automatyczne oznaczenie zapłaconych po dopasowaniu
python3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv --auto-mark

Obsługiwane formaty CSV:

mBank: nagłówek #Data operacji;Opis operacji;...;Kwota;Waluta
Generyczny: date/data, amount/kwota, description/opis

4. Dodawanie kontraktu (Python API)

from jdg_ksiegowy.registry.db import ContractRecord, save_contract, init_db
import uuid

init_db()
save_contract(ContractRecord(
    id=str(uuid.uuid4()),
    buyer_name="Firma XYZ",
    buyer_nip="5260250274",
    buyer_address="ul. Przykładowa 1, 00-001 Warszawa",
    buyer_email="kontakt@firma.pl",
    description="Obsługa IT — miesięczna",
    net_amount=2000,
    vat_rate=23,
    cycle="monthly",
    day_of_month=-1,   # -1 = ostatni dzień roboczy
))

Parametry kontraktu

Pole	Opis
`cycle`	`monthly` (jedyne obsługiwane)
`day_of_month`	`-1` = ostatni dzień roboczy, `1-28` = konkretny dzień
`auto_send_ksef`	Oznaczenie (wysyłkę KSeF wywołujesz osobno skill `ksef`)
`auto_send_email`	Oznaczenie (email wysyłasz osobno skill `invoice-send`)

Cron (codziennie rano)

0 7 * * * cd /opt/jdg && python3 skills/contracts/scripts/run_contracts.py >> logs/contracts.log 2>&1

---name: contractsdescription: Cykliczne kontrakty JDG — automatyczne wystawianie faktur miesięcznych, oznaczanie płatności, import CSV z banku. Użyj gdy user pyta "faktury automatyczne", "kontrakt cykliczny", "auto-fakturowanie", "subskrypcja klienta", "powtarzające się faktury", "oznacz jako zapłacone", "import wyciągu", "CSV bank", "które faktury nie zostały zapłacone".---# Cykliczne kontrakty + śledzenie płatności## 1. Auto-fakturowanie```bash# Uruchom na dziś (z crona lub ręcznie)python3 skills/contracts/scripts/run_contracts.py# Symulacja na konkretny dzieńpython3 skills/contracts/scripts/run_contracts.py --date 2026-04-30```## 2. Oznacz fakturę jako zapłaconą```bashpython3 skills/contracts/scripts/mark_paid.py "A1/04/2026"python3 skills/contracts/scripts/mark_paid.py "A1/04/2026" --date 2026-04-25```## 3. Import CSV z banku```bash# Podgląd dopasowań (bez zapisu)python3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv# Automatyczne oznaczenie zapłaconych po dopasowaniupython3 skills/contracts/scripts/import_bank_csv.py wyciag_kwiecien.csv --auto-mark```Obsługiwane formaty CSV:- **mBank**: nagłówek `#Data operacji;Opis operacji;...;Kwota;Waluta`- **Generyczny**: `date/data, amount/kwota, description/opis`## 4. Dodawanie kontraktu (Python API)```pythonfrom jdg_ksiegowy.registry.db import ContractRecord, save_contract, init_dbimport uuidinit_db()save_contract(ContractRecord( id=str(uuid.uuid4()), buyer_name="Firma XYZ", buyer_nip="5260250274", buyer_address="ul. Przykładowa 1, 00-001 Warszawa", buyer_email="kontakt@firma.pl", description="Obsługa IT — miesięczna", net_amount=2000, vat_rate=23, cycle="monthly", day_of_month=-1, # -1 = ostatni dzień roboczy))```## Parametry kontraktu| Pole | Opis ||------|------|| `cycle` | `monthly` (jedyne obsługiwane) || `day_of_month` | `-1` = ostatni dzień roboczy, `1-28` = konkretny dzień || `auto_send_ksef` | Oznaczenie (wysyłkę KSeF wywołujesz osobno skill `ksef`) || `auto_send_email` | Oznaczenie (email wysyłasz osobno skill `invoice-send`) |## Cron (codziennie rano)```bash0 7 * * * cd /opt/jdg && python3 skills/contracts/scripts/run_contracts.py >> logs/contracts.log 2>&1```

Frequently asked questions