calgebra

Compose calendars and query time intervals for availability and conflicts.

100|2|Updated Sep 27, 2025
One-click install
npx skills add https://github.com/ashenfad/calgebra --skill calgebra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calgebra
Source: https://github.com/ashenfad/calgebra/tree/main/calgebra/skills/calgebra
Command: npx skills add https://github.com/ashenfad/calgebra --skill calgebra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Calgebra provides a lazy, composable framework to model calendars as timelines and intervals, enabling efficient planning, conflict detection, and free-time discovery across sources.

Core Features & Use Cases

  • Lazy timeline composition and set-like operators for calendars and events.
  • Recurring patterns and interval-based filtering for schedules and availability.
  • iCalendar and Google Calendar compatibility for loading, querying, and exporting events.
  • Use Case: find free slots in a team calendar by combining multiple calendars and slicing by time bounds.

Quick Start

Create timelines from calendars and slice by timezone-aware bounds to retrieve events for a target date range.

Frequently Asked Questions about calgebra

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find free time slots across multiple calendars?

Find free time slots by composing multiple calendars into a single timeline and querying intervals for availability. You apply set-like operators to combine calendars, then slice the result by timezone-aware bounds to retrieve open durations.

Can I detect scheduling conflicts in recurring events?

Detect scheduling conflicts by modeling recurring patterns as intervals and applying set operations across composed timelines. The framework evaluates overlapping intervals to identify conflicts between recurring events and other calendar entries.

Does this work with Google Calendar and iCalendar formats?

Google Calendar and iCalendar formats are fully supported for loading, querying, and exporting events. You can import ICS files, compose them into timelines, and perform interval-based filtering while maintaining compatibility with these formats.

What is lazy timeline composition for calendar scheduling?

Lazy timeline composition is a method to model calendars as timelines and intervals without immediate evaluation. It allows efficient planning by deferring computation until you query time bounds, enabling set-like operators to combine calendars on demand.

How do I filter team availability by specific time durations?

Filter team availability by combining multiple calendars using set operations and applying duration-based filtering to the resulting timeline. Slice the composed timeline by timezone-aware bounds to retrieve intervals meeting specific duration requirements.

Do I need external dependencies to perform interval-based scheduling queries?

No external dependencies are required to perform interval-based scheduling queries. The framework operates independently to compose timelines, apply set operations, detect conflicts, and filter by durations without needing external libraries.