https://github.com/joshuaswarren/openclaw-skylight
OpenClaw skill to read & manage a Skylight Calendar household (calendar, chores, lists, Meals) via the skylight CLI
https://github.com/joshuaswarren/openclaw-skylight
agent-skill ai-agents cli home-automation meal-planning openclaw skylight skylight-calendar
Last synced: 12 days ago
JSON representation
OpenClaw skill to read & manage a Skylight Calendar household (calendar, chores, lists, Meals) via the skylight CLI
- Host: GitHub
- URL: https://github.com/joshuaswarren/openclaw-skylight
- Owner: joshuaswarren
- License: mit
- Created: 2026-06-13T20:38:18.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2026-06-14T13:18:17.000Z (24 days ago)
- Last Synced: 2026-06-14T15:14:06.967Z (23 days ago)
- Topics: agent-skill, ai-agents, cli, home-automation, meal-planning, openclaw, skylight, skylight-calendar
- Language: Shell
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# openclaw-skylight
> Part of a three-repo set: [`pyskylight`](https://github.com/joshuaswarren/pyskylight)
> (client + CLI) · **openclaw-skylight** (this) ·
> [`plantoeat-skylight-sync`](https://github.com/joshuaswarren/plantoeat-skylight-sync) (meal-plan sync).
An [OpenClaw](https://openclaw.ai/) **skill** that lets your OpenClaw agents read and
manage a [Skylight Calendar](https://www.skylightframe.com/) / Buddy household —
calendar events, family chores/lists, and especially **Meals** (recipes + the meal
plan) — by driving the open-source [`pyskylight`](https://github.com/joshuaswarren/pyskylight)
CLI.
Skylight has no official API; this builds on the community-reverse-engineered private
app API. **Personal use, your own account only.**
## What it is
A single `SKILL.md` (plus this README and an installer). OpenClaw reads `SKILL.md` and
learns how to call the `skylight` CLI. No long-running process, no gateway restart —
it's a drop-in skill.
## Install
```bash
git clone https://github.com/joshuaswarren/openclaw-skylight
cd openclaw-skylight
./install.sh
```
`install.sh` will:
1. Install the `skylight` CLI (`pipx install pyskylight`, falling back to `pip --user`).
2. Copy `SKILL.md` into `~/.openclaw/skills/skylight/` (override with `OPENCLAW_SKILLS_DIR`).
Then make credentials available to the OpenClaw environment (1Password references
recommended):
```bash
export SKYLIGHT_EMAIL="op://Shared/Skylight/username"
export SKYLIGHT_PASSWORD="op://Shared/Skylight/password"
export SKYLIGHT_FRAME_ID="…" # optional
export SKYLIGHT_TIMEZONE="America/Chicago"
```
## Usage
Ask your agent things like *"what meals are planned this week on the Skylight?"* or
*"add tacos to the Skylight meal plan for Friday dinner."* The agent runs the
`skylight` CLI and parses the JSON output. See [`SKILL.md`](SKILL.md) for the full
command surface.
## Related
- [`pyskylight`](https://github.com/joshuaswarren/pyskylight) — the client + CLI this skill wraps.
- [`plantoeat-skylight-sync`](https://github.com/joshuaswarren/plantoeat-skylight-sync) — scheduled Plan to Eat → Skylight meal-plan sync.
## License
[MIT](LICENSE). Unofficial; not affiliated with or endorsed by Skylight or OpenClaw.