How do I install the Calendar Sync skill?

Run npx skillmds@latest add dithiothreitol/calendar-sync 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 Calendar Sync 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 Calendar Sync?

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

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

Who published Calendar Sync?

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

Calendar Sync by dithiothreitol — Agent Skill

Name: Calendar Sync
Author: dithiothreitol

Calendar Sync

Synchronizuje terminy podatkowe JDG (ryczałt, ZUS, VAT+JPK) i przypomnienia o fakturach — z kwotami — do dedykowanego kalendarza Google "JDG Podatki". Idempotentne (tworzy/aktualizuje/usuwa). Użyj gdy user mówi "synchronizuj kalendarz", "dodaj terminy do kalendarza", "wrzuć podatki do Google Calendar", "przypomnienia w kalendarzu", "kalendarz podatkowy", lub gdy pyta czemu nie widzi terminów/kwot w kalendarzu.

File contents

Synchronizacja terminów podatkowych z Google Calendar

Czyta przypomnienia z dashboardu (status/dashboard.py — terminy podatkowe + niezapłacone/zaległe faktury, z kwotami) i uzgadnia je z kalendarzem „JDG Podatki" przez Google Calendar API. Wydarzenia całodniowe na termin płatności, z popupami N dni przed i w dniu.

Wymagana konfiguracja (jednorazowo)

Google Cloud Console → utwórz OAuth client ID typu „Desktop app", pobierz credentials.json.
W .env: GCAL_ENABLED=true, GCAL_CREDENTIALS_PATH=/sciezka/credentials.json.
python -m jdg_ksiegowy.calendar.auth_setup — jednorazowa zgoda w przeglądarce (zapisuje refresh token).

Jeśli skrypt zwróci błąd „nie skonfigurowany" / „Brak tokenu" — przerwij i poprowadź usera przez powyższe kroki.

Wywołanie

# Podglad (NIC nie zapisuje) — pokaz co by sie zmienilo:
python3 skills/calendar-sync/scripts/sync.py --dry-run

# Synchronizacja:
python3 skills/calendar-sync/scripts/sync.py

Zwraca JSON: created / updated / deleted / unchanged (listy kluczy wydarzeń) + dry_run.

Zachowanie

Idempotentne: ponowne uruchomienie bez zmian → wszystko w unchanged.
Kwoty się aktualizują: zmiana szacowanej kwoty (np. po dodaniu faktury/kosztu) → updated.
Zapłacone faktury znikają: po oznaczeniu faktury jako zapłaconej jej przypomnienie wypada z dashboardu → wydarzenie zostaje usunięte z kalendarza.
Dotyka wyłącznie wydarzeń utworzonych przez aplikację (oznaczonych jdg_managed) — nigdy nie rusza prywatnych wpisów usera.

Automatyzacja

Cron OpenClaw odpala to codziennie (patrz CRON.md): 0 7 * * *. Dzięki temu kwoty są świeże, a zapłacone faktury automatycznie znikają.

Uwagi

Kwota VAT+JPK jest szacunkowa (należny − naliczony za poprzedni miesiąc); autorytatywna kwota pochodzi ze skilla jpk.
Nigdy nie loguj tokenu OAuth do outputu.

---name: calendar-syncdescription: Synchronizuje terminy podatkowe JDG (ryczałt, ZUS, VAT+JPK) i przypomnienia o fakturach — z kwotami — do dedykowanego kalendarza Google "JDG Podatki". Idempotentne (tworzy/aktualizuje/usuwa). Użyj gdy user mówi "synchronizuj kalendarz", "dodaj terminy do kalendarza", "wrzuć podatki do Google Calendar", "przypomnienia w kalendarzu", "kalendarz podatkowy", lub gdy pyta czemu nie widzi terminów/kwot w kalendarzu.---# Synchronizacja terminów podatkowych z Google CalendarCzyta przypomnienia z dashboardu (`status/dashboard.py` — terminy podatkowe + niezapłacone/zaległefaktury, z kwotami) i uzgadnia je z kalendarzem **„JDG Podatki"** przez Google Calendar API.Wydarzenia całodniowe na termin płatności, z popupami N dni przed i w dniu.## Wymagana konfiguracja (jednorazowo)1. Google Cloud Console → utwórz **OAuth client ID** typu „Desktop app", pobierz `credentials.json`.2. W `.env`: `GCAL_ENABLED=true`, `GCAL_CREDENTIALS_PATH=/sciezka/credentials.json`.3. `python -m jdg_ksiegowy.calendar.auth_setup` — jednorazowa zgoda w przeglądarce (zapisuje refresh token).Jeśli skrypt zwróci błąd „nie skonfigurowany" / „Brak tokenu" — przerwij i poprowadź usera przez powyższe kroki.## Wywołanie```bash# Podglad (NIC nie zapisuje) — pokaz co by sie zmienilo:python3 skills/calendar-sync/scripts/sync.py --dry-run# Synchronizacja:python3 skills/calendar-sync/scripts/sync.py```Zwraca JSON: `created` / `updated` / `deleted` / `unchanged` (listy kluczy wydarzeń) + `dry_run`.## Zachowanie- **Idempotentne**: ponowne uruchomienie bez zmian → wszystko w `unchanged`.- **Kwoty się aktualizują**: zmiana szacowanej kwoty (np. po dodaniu faktury/kosztu) → `updated`.- **Zapłacone faktury znikają**: po oznaczeniu faktury jako zapłaconej jej przypomnienie wypada z dashboardu → wydarzenie zostaje **usunięte** z kalendarza.- Dotyka **wyłącznie** wydarzeń utworzonych przez aplikację (oznaczonych `jdg_managed`) — nigdy nie rusza prywatnych wpisów usera.## AutomatyzacjaCron OpenClaw odpala to codziennie (patrz `CRON.md`): `0 7 * * *`. Dzięki temu kwoty są świeże,a zapłacone faktury automatycznie znikają.## Uwagi- Kwota VAT+JPK jest **szacunkowa** (należny − naliczony za poprzedni miesiąc); autorytatywna kwota pochodzi ze skilla `jpk`.- Nigdy nie loguj tokenu OAuth do outputu.

Frequently asked questions