К основному содержанию
скилл CX Codex

terminy — скилл для Claude Code: сроки и установка

Скилл terminy для Claude Code считает рабочие дни, праздники и сроки по польским правилам. Запускается на запросы о датах платежей, налогов и нормах рабочего времени.

MIT ★ 60 обновлён 2026-11-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install terminy@polskie-skille
Открыть на GitHub

Что делает terminy

Скилл считает рабочие дни между датами, месячную норму рабочего времени и польские государственные праздники. Он проверяет отдельный день, рассчитывает срок от даты и выводит сроки ZUS, PIT, CIT, VAT/JPK_V7M и PPK. Результаты скрипта содержат правовое основание каждого правила.

Расчёты выполняет scripts/terminy.py без подключения к сети; данные выдаются в JSON. Для запуска нужен Python 3.8+, используются только модули стандартной библиотеки. Норма рабочего времени рассчитана для полной занятости и месячного расчётного периода, а налоговые сроки охватывают стандартные месячные расчёты.

Какие задачи решает

  • посчитать рабочие дни между двумя датами
  • узнать норму рабочего времени за месяц
  • проверить, рабочий ли конкретный день
  • рассчитать дату оплаты с переносом на следующий рабочий день
  • найти сроки ZUS, PIT, CIT, VAT/JPK_V7M и PPK за месяц

Примеры запросов агенту

  • Посчитай рабочие дни между 2026-10-01 и 2026-12-31.
  • Проверь, рабочий ли день 2026-12-24.
  • Найди сроки ZUS и VAT за расчётный месяц 2026-09.

Как установить terminy

1Через маркетплейс плагинов

/plugin marketplace add b44x/ai-polish-skills
/plugin install terminy@polskie-skille

Команда ставит плагин terminy целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill terminy -a claude-code

3Вручную: положить файлы

~/.claude/skills/terminy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/terminy/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о terminy

Как установить terminy в Claude Code?

Выполни /plugin marketplace add b44x/ai-polish-skills и затем /plugin install terminy@polskie-skille.

Что делает terminy?

Считает рабочие дни и нормы рабочего времени, проверяет польские праздники и вычисляет сроки платежей и налогов. К результатам добавляются правовые основания.

Что нужно для работы terminy?

Нужен Python 3.8+. Скилл запускает scripts/terminy.py, использует стандартную библиотеку Python и работает офлайн.

Исходный текст

SKILL.md · MIT
---
name: terminy
display_name: Terminy, dni robocze i święta
version: 1.0.0
description: >-
  Polish working days, public holidays and deadlines, computed offline with legal citations.
  Count working days between dates, get the monthly working-time norm (wymiar czasu pracy) per
  art. 130 Kodeksu pracy, list statutory holidays (including Wigilia 24 December from 2025), check a
  single day, compute a deadline such as invoice payment terms (date + N days, moved to the next
  working day under art. 115 KC), and list monthly tax and social-security deadlines (ZUS, PIT, CIT,
  VAT/JPK_V7M, PPK) moved off weekends and holidays per art. 12 § 5 Ordynacji podatkowej. Use whenever
  the user asks e.g. "ile dni roboczych w październiku", "wymiar czasu pracy grudzień",
  "do kiedy zapłacić ZUS", "termin VAT za wrzesień", "czy 24 grudnia jest wolny",
  "termin płatności 14 dni od faktury", "kiedy wypada Boże Ciało".
category: utilities
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: false
authentication: none
source: Polskie przepisy (ustawa o dniach wolnych od pracy, Kodeks pracy, Ordynacja podatkowa, Kodeks cywilny, ustawy podatkowe)
source_type: static_data
official: false
homepage: https://isap.sejm.gov.pl
documentation: none
rate_limit: none
last_verified: 2026-09-28
tags:
  - dni-robocze
  - swieta
  - wymiar-czasu-pracy
  - terminy
  - zus
  - vat
  - pit
  - ksiegowosc
compatibility: Python 3.8+ (standard library only); works fully offline.
---

# Polish working days, holidays and deadlines

Computes Polish working days, holidays, working-time norms and tax/ZUS deadlines with
`scripts/terminy.py`. Fully offline and deterministic. Always outputs structured JSON with the
legal basis of each rule.

## Running the script

Run from this skill's directory (or use relative path from repo root):

| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/terminy.py <command> …` |
| Windows | `py scripts/terminy.py <command> …` (or `python`) |

Zero external dependencies required (standard library only).

## Workflow

1. **Working days and working-time norm in a month** ("ile dni roboczych w październiku", "wymiar czasu pracy grudzień 2026"):
   `python3 scripts/terminy.py month 2026-12`
   - Report `workingDays` and `workingTimeNormHours`, and show `calculation`.
   - A holiday falling on Saturday reduces the norm too (art. 130 § 2 KP). Mention `saturdayHolidays` when present.

2. **Tax and ZUS deadlines** ("do kiedy ZUS za wrzesień", "termin VAT"):
   `python3 scripts/terminy.py deadlines 2026-09`
   `python3 scripts/terminy.py deadlines 2026-09 --only vat zus-pozostali`
   - The argument is the **settlement month**; the deadlines fall in the following month.
   - ZUS depends on the payer: `zus-pozostali` (JDG, partnerships) = 20th, `zus-osoby-prawne` (sp. z o.o., S.A.) = 15th,
     `zus-jednostki-budzetowe` = 5th. Ask the user which applies if unclear.
   - When `shifted` is true, say the deadline moved from `nominalDate` because of a weekend or holiday.

3. **Payment term / any "N days from" deadline** ("termin płatności 14 dni od 2026-10-15"):
   `python3 scripts/terminy.py add 2026-10-15 14`
   `python3 scripts/terminy.py add 2026-12-22 5 --workdays` (N working days)

4. **Working days between two dates:** `python3 scripts/terminy.py workdays 2026-10-01 2026-12-31`

5. **Holidays and single days:** `python3 scripts/terminy.py holidays --year 2027`, `python3 scripts/terminy.py day 2026-12-24`

## Commands

| Command | Description | Returns |
|---|---|---|
| `month <YYYY-MM>` | Working days and working-time norm (full-time, 1-month period) | `workingDays`, `workingTimeNormHours`, `holidays`, `saturdayHolidays`, `calculation` |
| `deadlines <YYYY-MM> [--only ID…]` | ZUS, PIT, CIT, VAT (JPK_V7M), PPK deadlines for a settlement month | `deadlines[]` with `deadline`, `nominalDate`, `shifted`, `legalBasis` |
| `add <date> <N> [--workdays]` | Date + N calendar days (moved to the next working day) or + N working days | `deadline` / `result`, `shifted`, `rule` |
| `workdays <from> <to>` | Working days between two dates, inclusive | `workingDays`, `calendarDays`, `holidays` |
| `holidays [--year Y]` | Statutory holidays of a year | `holidays[]` with `date`, `weekday`, `name` |
| `day <date>` | Is the date a working day or a holiday | `isWorkingDay`, `holiday`, `nextWorkingDay` |

Legal basis of every rule: [references/output.md](references/output.md).

## Exit codes

JSON goes to stdout; errors go to stderr as `{"error": "...", "type": "..."}`.

| Code | Meaning | What to do |
|---|---|---|
| `0` | Success | Use the JSON output |
| `2` | Not found | No deadline matches the `--only` filter |
| `64` | Bad usage / validation | Invalid date (expected YYYY-MM-DD) or month (YYYY-MM), year outside 1990–2100 |

## Rules

- The working-time norm assumes a full-time employee and a one-month settlement period. For other
  settlement periods or part-time contracts, say so and compute proportionally only if the user asks.
- The deadlines cover standard monthly settlements. They do not cover quarterly settlements, the
  cash method (metoda kasowa), exceptions in specific cases, or changes to the law after
  `rulesVerified`. For current law use the `prawo` skill, and do not present the output as tax advice.
- Regional or company days off (e.g. a day off in exchange for a Saturday holiday) are not statutory
  holidays and are not included.

© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
entity-verification entia MCP-сервер entity-verification проверяет компании, VAT, владельцев и риск-сигналы через данные BORME, VIES, GLEIF и Wikidata. CX Codex +1 16 045установок czech-vat-mcp janmacher02-xl8y MCP-сервер czech-vat-mcp проверяет чешские компании и банковские счета, статус плательщика НДС и номера НДС стран ЕС. Пригодится перед расчётами с поставщиками. CX Codex +1 889установок VAT Validator MCP ojaskord MCP-сервер VAT Validator MCP проверяет номера НДС в реестрах ЕС, Великобритании и Австралии прямо через ИИ-агента. Помогает сверить имя в инвойсе до проведения оплаты. CX Codex +1 42установок margin-analyzer ilyautov Скилл margin-analyzer для Claude Code и Codex разбирает выручку и затраты по товарам и услугам, учитывает НДС и показывает сценарии изменения цены. Считает, какие позиции приносят прибыль. CX Codex +1 ★ 38звёзд репо norman norman-finance Подключает финансовый сервис Norman к Claude Code для выставления счетов, сверки транзакций и подготовки налоговой отчётности в Германии и Польше. ★ 65звёзд репо Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres Ekwo-ai Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres — MCP-сервер для Claude Code связывает агента с бухгалтерией, счетами, проводками и НДС с соблюдением прав доступа. CX Codex +1 ★ 43звёзд репо

Из того же набора52

Весь набор →
filmweb Получает сведения о фильмах и сериалах с Filmweb. Агент включает его для поиска по названию или ссылке, вопросов об актёрах, оценках, премьерах и VOD. CX Codex +1 ★ 60звёзд репо dzialki Скилл dzialki для Claude Code находит польские кадастровые участки через сервис ULDK. Запросите участок по идентификатору EGiB, кадастровому району с номером или точке на карте. CX Codex +1 ★ 60звёзд репо odjazdy Скилл odjazdy для Claude Code показывает остановки и ближайшие отправления автобусов и трамваев в Гданьске, Познани и Щецине. Запрашивайте табло по названию остановки или её ID. CX Codex +1 ★ 60звёзд репо biala-lista Скилл biala-lista для Claude Code проверяет польские компании и их статус плательщика VAT по NIP или REGON. Запускается при проверке контрагента, счёта или польской фактуры. CX Codex +1 ★ 60звёзд репо nieruchomosci Скилл nieruchomosci для Claude Code ищет записи о сделках с недвижимостью в польском реестре RCN. Можно искать рядом с координатами или в заданной области и фильтровать результаты по дате, рынку и площади. CX Codex +1 ★ 60звёзд репо sejm Скилл sejm для Claude Code обращается к официальному API польского Сейма. Агент подключает его для поиска депутатов, голосований, законопроектов и депутатских запросов. CX Codex +1 ★ 60звёзд репо prawo Скилл prawo для Claude Code ищет польские законы через официальный API Сейма. Он находит статьи, статус акта и сведения о поправках. CX Codex +1 ★ 60звёзд репо imgw Получает данные IMGW-PIB о погоде, предупреждениях и уровнях воды в Польше. Запускается на запросы о температуре, ветре, осадках или состоянии рек. CX Codex +1 ★ 60звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой