How do I install the Jetlag Planner skill?

Run npx skillmds@latest add dvcrn/jetlag-planner in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Jetlag Planner safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Jetlag Planner?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Jetlag Planner free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Jetlag Planner?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Jetlag Planner by dvcrn — Agent Skill

Name: Jetlag Planner
Rating: 4.5 (4 reviews)
Author: dvcrn

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 my flights", "run jetlag planner", "plan my trip adjustment", or "am I ready for my upcoming flight".

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Run the jetlag planner by following these steps exactly.

Step 1 — Check for .env

Check whether the file ~/openclaw-jetlag/.env exists.

If it does not exist, stop immediately and reply:

⚠️ No .env file found in ~/openclaw-jetlag/. You need to add your Google OAuth credentials before I can run the planner. Follow the setup instructions in the README — ask me "show me the jetlag setup instructions" if you need them.

Step 2 — Check for .oauth-token.json

Check whether the file ~/openclaw-jetlag/.oauth-token.json exists.

If it does not exist, stop immediately and reply:

⚠️ Google authorization hasn't been completed yet. Run this once in your terminal to finish setup:
cd ~/openclaw-jetlag && node index.js
It will open a browser, ask you to sign in to Google, and save your authorization. After that, just say "check my flights" again and I'll handle it from here.

Step 3 — Run the planner

Run the following command and capture all output (stdout and stderr):

cd ~/openclaw-jetlag && node index.js

Step 4 — Report back

Reply with a short, plain-language Telegram-friendly summary. Do not dump raw output. Instead:

If flights were detected and plans were written, say which flights were found (route and date) and how many calendar events were created total.
If the output says no flight events were found, reply: "No upcoming flights found in your calendar for the next 90 days. If you have flights coming up, check that your airline confirmation emails are in the Gmail account linked to this calendar."
If flights were found but all were skipped (under 2-hour timezone shift), reply: "Found [N] flight(s) but all had under a 2-hour timezone shift, so no adjustment plan was needed."
If the command exited with a non-zero code or printed an error, relay the error message directly and suggest running cd ~/openclaw-jetlag && node index.js manually to see the full output.

Keep the reply under 5 sentences. No markdown headers in the Telegram reply — just plain text with line breaks between items if listing multiple flights.

---name: jetlag-plannerdescription: Scans your Google Calendar for upcoming flights and writes a personalized circadian adjustment plan back to your calendar. Trigger with phrases like "check my flights", "run jetlag planner", "plan my trip adjustment", or "am I ready for my upcoming flight".---Run the jetlag planner by following these steps exactly.## Step 1 — Check for .envCheck whether the file `~/openclaw-jetlag/.env` exists.If it does not exist, stop immediately and reply:> ⚠️ No `.env` file found in `~/openclaw-jetlag/`. You need to add your Google OAuth credentials before I can run the planner. Follow the setup instructions in the README — ask me "show me the jetlag setup instructions" if you need them.## Step 2 — Check for .oauth-token.jsonCheck whether the file `~/openclaw-jetlag/.oauth-token.json` exists.If it does not exist, stop immediately and reply:> ⚠️ Google authorization hasn't been completed yet. Run this once in your terminal to finish setup:>> ```> cd ~/openclaw-jetlag && node index.js> ```>> It will open a browser, ask you to sign in to Google, and save your authorization. After that, just say "check my flights" again and I'll handle it from here.## Step 3 — Run the plannerRun the following command and capture all output (stdout and stderr):```bashcd ~/openclaw-jetlag && node index.js```## Step 4 — Report backReply with a short, plain-language Telegram-friendly summary. Do not dump raw output. Instead:- If flights were detected and plans were written, say which flights were found (route and date) and how many calendar events were created total.- If the output says no flight events were found, reply: "No upcoming flights found in your calendar for the next 90 days. If you have flights coming up, check that your airline confirmation emails are in the Gmail account linked to this calendar."- If flights were found but all were skipped (under 2-hour timezone shift), reply: "Found [N] flight(s) but all had under a 2-hour timezone shift, so no adjustment plan was needed."- If the command exited with a non-zero code or printed an error, relay the error message directly and suggest running `cd ~/openclaw-jetlag && node index.js` manually to see the full output.Keep the reply under 5 sentences. No markdown headers in the Telegram reply — just plain text with line breaks between items if listing multiple flights.

Frequently asked questions