Doctor

Skill dithiothreitol/jdg-ksiegowy/.claude/skills/doctor

Preflight-check konfiguracji JDG przed wysyłką faktur / JPK do sandboxów. Sprawdza dane sprzedawcy, KSeF, bramkę MF, SMTP, OCR, Google Calendar. Użyj gdy user pyta "czy wszystko skonfigurowane", "diagnostyka", "preflight", "co mam brak", "czy działa konfiguracja", "audyt setupu".From its SKILL.md

Install

npx -y skills add dithiothreitol/jdg-ksiegowy --skill doctor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

reads credentialsReads from 1 credential source: `.env`.
5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 3 commands, including `python3 skills/doctor/scripts/check.py` and 2 more.

SKILL.md

1.9 KB, 549 tokens by cl100k_base, as published. Nobody here has run it

Doctor — sprawdzanie konfiguracji

Waliduje .env i obecność plików (certyfikaty, klucze) przed wysyłką do KSeF/MF. Nie dotyka sieci.

Wywołanie

# Raport tekstowy
python3 skills/doctor/scripts/check.py

# Format JSON
python3 skills/doctor/scripts/check.py --format json

# Exit code != 0 gdy są błędy (do CI)
python3 skills/doctor/scripts/check.py --fail-on-error

Co sprawdza

[SELLER] — dane sprzedawcy z .env:

SELLER_NIP (z walidacją sumy kontrolnej)
SELLER_NAME, SELLER_ADDRESS, SELLER_BANK_ACCOUNT/NAME
SELLER_EMAIL, SELLER_FIRST_NAME/LAST_NAME, SELLER_BIRTH_DATE, SELLER_TAX_OFFICE_CODE (dla JPK)

[KSEF]:

KSEF_ENV (test/demo/prod), pochodny URL API
KSEF_NIP + KSEF_TOKEN

[MF] (bramka JPK):

MF_ENV (test/prod), pochodny URL
MF_PESEL (z walidacją), MF_CERT_PATH/MF_CERT_URL

[SMTP] — wysyłka email (opcjonalne):

SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD

[OCR] — provider i klucze:

OCR_PROVIDER (auto/ollama/claude), ANTHROPIC_API_KEY jeśli claude

Poziomy

OK — obszar gotowy
WARN — brak nieblokujący (np. SMTP) — część funkcjonalności niedostępna
ERROR — krytyczny — wysyłka zadziała dopiero po naprawie

Flow po doctor

Jeśli wszystko OK → możesz ruszać z wysyłkami:

# Dry-run na sandboxie KSeF
python3 skills/ksef/scripts/submit.py --dry-run --invoice-file faktury/A1.xml

# Dry-run JPK (sandbox MF)
python3 skills/jpk-submit/scripts/submit.py --dry-run data/jpk/JPK_V7M_04_2026.xml

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.