Skylight Calendar for Openclaw

A comprehensive AI agent skill for programmatically managing Skylight Calendar frames, family chores, and household lists.

riyadchowdhury
v1.0.0
Jan 27, 2026
4
2.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install skylight-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install skylight-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Skylight Calendar?

The Skylight Calendar skill for Openclaw Skills provides a robust interface to interact with your physical Skylight smart display via its unofficial API. It allows developers and AI agents to manage the entire household ecosystem, from scheduling family events to tracking rewards for completed chores. By integrating this skill, users can bridge the gap between automated digital workflows and the central hub of their home's organization.

This integration is particularly valuable for those looking to enhance their smart home automation using Openclaw Skills. It enables programmatic control over shopping lists, to-do items, and family categories, ensuring that every member of the household stays synchronized. The skill handles complex JSON:API structures and provides clear pathways for both email-based authentication and manual token management.

Skylight Calendar Use Cases

  • Automating the creation of recurring family chores and assigning them to specific members.
  • Synchronizing grocery lists from external apps directly to the Skylight shopping list.
  • Programmatic monitoring of reward points to gamify household tasks for children.
  • Updating the family calendar with events triggered by external services or AI assistants.
  • Retrieving frame-specific metadata to monitor the status of connected smart devices via Openclaw Skills.

How Skylight Calendar Works

  1. The skill authenticates with the Skylight API using either an email/password login flow or a manually captured authorization token.
  2. It identifies the target household using the unique SKYLIGHT_FRAME_ID found in the user's account URL.
  3. The AI agent communicates with the unofficial API using standardized GET and POST requests formatted for JSON:API.
  4. Data is retrieved and parsed using tools like jq to handle complex relationships between events, categories, and items.
  5. Actions such as chore completion or list updates are pushed to the cloud and reflected in real-time on the physical Skylight display.

Skylight Calendar Setup

To integrate this with Openclaw Skills, you must first configure your environment variables. Ensure curl is installed on your system.

# Required Configuration
export SKYLIGHT_FRAME_ID="your_numeric_frame_id"

# Option A: Credentials (Recommended)
export SKYLIGHT_EMAIL="your_account_email"
export SKYLIGHT_PASSWORD="your_account_password"

# Option B: Manual Token
export SKYLIGHT_TOKEN="Basic <your_base64_encoded_token>"

You can find your frame ID by logging into the Skylight web portal and extracting the numeric ID from the calendar URL.

Skylight Calendar Data Schema & Taxonomy

The skill organizes information using the JSON:API specification. Below is the primary data structure for core resources managed by Openclaw Skills:

Resource Attributes Relationships
Calendar Event summary, start, end, timezone categories, calendar_account
Chore summary, status (pending/completed), reward_points category (user profile)
List label, kind (shopping/to_do) included list_items
Task Box summary, emoji_icon, routine N/A
Category label (name), color, profile_pic_url N/A
Reward label, points, redeemed_at N/A

Skylight Calendar Advanced Features

  • Support for complex recurring chore logic using RRULE strings.
  • Multi-profile management through family Categories for personalized task assignment.
  • Real-time synchronization of shopping list sections and item positions.
  • Reward point tracking with redemption history filtering.
  • Support for proxy-based token capture for advanced authentication scenarios within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*