calendar-conventions

What problem does it solve?

This Skill addresses inconsistencies in implementing calendars and timekeeping systems, preventing errors in date conversions, timezone handling, and epoch calculations that could lead to inaccurate historical or cultural date representations in the Library of Time project.

Core Features & Use Cases

• Core Conventions: Defines standards for year numbering (including BCE as negative integers), preferring createAdjustedDateTime over raw Date constructors, and explicit epoch anchors in local timezones.
• Implementation Guidance: Covers day-boundary logic with non-midnight starts (e.g., sunrise), load-time safety to avoid script dependencies, and patterns for conversion functions like toGregorian and fromGregorian.
• Use Case: When adding a new lunisolar calendar like the Hebrew system, use this Skill to ensure weekday calculations align with sunset boundaries and all arithmetic uses shared utilities for consistency across the project.

Quick Start

Apply the calendar-conventions skill to refactor the Coptic calendar logic in CalendarAPI/Calendars ensuring proper BCE handling and timezone offsets.