← Back to Skills Marketplace
Jetlag Planner
by
chadholdorf
· GitHub ↗
· v0.1.0
· MIT-0
335
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-jetlag
Description
Scans your Google Calendar for upcoming flights and writes a personalized circadian adjustment plan back to your calendar. Trigger with phrases like "check m...
Usage Guidance
What to consider before installing:
- This skill requires Node.js >=18 and a Google OAuth Client ID/Secret (put in ~/openclaw-jetlag/.env) even though the registry metadata doesn't declare those — that mismatch is suspicious. Verify you will run the code in a directory you control and that you will create a dedicated Google OAuth client for this tool (do not reuse credentials from other apps).
- The skill will save an OAuth token (.oauth-token.json) and then can autonomously read and write your Calendar events (it will create many reminder events). If you are uncomfortable with a skill creating calendar events automatically, do not install or run it.
- Inspect index.js yourself (it is included) or run it in an isolated account/environment first. If you don't trust the unknown source, create a throwaway Google account and a separate Google Cloud OAuth client to test so your primary account's data and credentials are not exposed.
- Ask the publisher for source provenance (why registry metadata omits required env vars and Node), or prefer a skill whose declared requirements match its runtime behavior.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-jetlag
Version: 0.1.0
The openclaw-jetlag skill is a legitimate utility designed to automate circadian rhythm adjustment plans by scanning a user's Google Calendar for flight events. The logic in index.js uses the official googleapis library to read flight details and write suggested sleep/light exposure schedules back to the calendar. The skill requires the user to provide their own Google OAuth credentials and perform a one-time manual authorization to generate a local token. There is no evidence of data exfiltration, malicious execution, or obfuscation; the code is well-structured and its behavior aligns perfectly with the stated purpose.
Capability Assessment
Purpose & Capability
The skill legitimately needs Google OAuth credentials and Node.js to access and modify your Google Calendar, but the registry metadata declares no required env vars or binaries. That mismatch (no declared GOOGLE_CLIENT_ID/SECRET or Node requirement) is an incoherence you should understand before installing.
Instruction Scope
SKILL.md explicitly instructs the agent to check for files in ~/openclaw-jetlag (.env and .oauth-token.json) and to run `cd ~/openclaw-jetlag && node index.js`, capturing stdout/stderr. The runtime instructions scope is otherwise limited to calendar scanning and writing events; they do not instruct exfiltration to third-party endpoints. However they do require access to local files and to run a local binary (node).
Install Mechanism
There is no install spec in the registry, yet the code (README and SKILL.md) expects you to clone the repo and run `npm install` / `node index.js`. The skill includes code and npm dependencies but does not declare Node/npm as required binaries in metadata — this is an inconsistency and increases accidental misconfiguration risk.
Credentials
The skill requires sensitive environment values (GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET stored in a .env) and will persist OAuth tokens to .oauth-token.json to allow future autonomous runs. Those credentials are necessary for the stated Calendar access, so their request is proportionate — but the skill failed to declare them in metadata, which is a red flag. README's suggestion to 'ask your Claw bot for the Client ID/Secret' raises additional caution about how credentials might be sourced.
Persistence & Privilege
The skill writes an OAuth token file (.oauth-token.json) and will create many calendar events in your Google Calendar. It does not request 'always: true' or modify other skills. The combination of autonomous invocation (default) plus saved OAuth credentials means once authorized the skill can run without interactive approval — that is expected for this use but worth noting.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-jetlag - After installation, invoke the skill by name or use
/openclaw-jetlag - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of jetlag-planner, an assistant for automatic circadian adjustment planning:
- Scans your Google Calendar for upcoming flights using triggered phrases like "check my flights" or "run jetlag planner".
- Writes personalized jetlag adjustment plans back into your calendar based on detected flights.
- Guides setup with clear instructions if OAuth credentials or authorization are missing.
- Summarizes results concisely, listing flights, events created, or reasons no plan was made.
Metadata
Frequently Asked Questions
What is Jetlag Planner?
Scans your Google Calendar for upcoming flights and writes a personalized circadian adjustment plan back to your calendar. Trigger with phrases like "check m... It is an AI Agent Skill for Claude Code / OpenClaw, with 335 downloads so far.
How do I install Jetlag Planner?
Run "/install openclaw-jetlag" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Jetlag Planner free?
Yes, Jetlag Planner is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Jetlag Planner support?
Jetlag Planner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Jetlag Planner?
It is built and maintained by chadholdorf (@chadholdorf); the current version is v0.1.0.
More Skills