← Back to Skills Marketplace
kurosh87

Aerobase Jetlag

by Aerobase · GitHub ↗ · v3.3.1 · MIT-0
cross-platform ⚠ suspicious
500
Downloads
0
Stars
1
Active Installs
20
Versions
Install in OpenClaw
/install aerobase-jetlag
Description
Jetlag recovery optimization - score flights, generate recovery plans, optimize travel timing
README (SKILL.md)

Aerobase Jetlag Recovery 😴

This skill makes jetlag decisions actionable: score fatigue impact, then return an easy recovery plan users can execute the same day.

Setup

Use this skill by getting a free API key at https://aerobase.app/openclaw-travel-agent and setting AEROBASE_API_KEY in your agent environment. This skill is API-only: no scraping, no browser automation, and no user credential collection.

Usage is capped at 5 requests/day for free users. Upgrade to Pro ($9.95/month) at https://aerobase.app/openclaw-travel-agent for 500 API calls/month.

Agent API Key Protocol

  • Base URL: https://aerobase.app
  • Required env var: AEROBASE_API_KEY
  • Auth header (preferred): Authorization: Bearer ${AEROBASE_API_KEY}
  • Never ask users for passwords, OTPs, cookies, or third-party logins.
  • Never print raw API keys in output; redact as sk_live_***.

Request rules

  • Use only Aerobase endpoints documented in this skill.
  • Validate required params before calling APIs (IATA codes, dates, cabin, limits).
  • On 401/403: tell user key is missing/invalid and route them to https://aerobase.app/openclaw-travel-agent.
  • On 429: explain free-tier quota (5 requests/day) and suggest Pro ($9.95/month, 500 API calls/month) or Lifetime ($249, 500 API calls/month).
  • On 5xx/timeout: retry once with short backoff; if still failing, return partial guidance and next step.
  • Use concise responses: top options first, then 1-2 follow-up actions.

What this skill does

  • Score any flight for jetlag impact (0-100).
  • Generate personalized recovery plans.
  • Suggest timing, sleep adjustments, and in-flight routines.
  • Estimate accelerated functional recovery days.
  • Treat 0 recovery days as negligible circadian disruption, not missing data.

Endpoints

  • POST /api/v1/flights/score — score a flight for jetlag impact with canonical jetlagScore (0-100).
  • POST /api/v1/recovery/plan — generate a personalized accelerated recovery plan.

Usage limits

  • Free: 5 requests/day
  • Pro: 500 API calls/month (upgrade at $9.95/month)
  • Lifetime: $249 for 500 API calls/month

Example usage pattern

  • User asks: "How hard is LHR → JFK on this option?"
    Use /api/v1/flights/score.
  • User asks: "Help me recover better"
    Use /api/v1/recovery/plan with their likely sleep window and timezone context.
  • For 0-2h shifts, frame results as minimal/negligible circadian disruption rather than a full jetlag reset problem.

Safety

  • Never infer or request secrets.
  • Keep the plan practical: clear action list, no unsafe medical or dosing recommendations.
  • Offer alternatives when recovery burden is high (later departure, longer stay buffer, airport adjustments).

Pro Superpowers

Upgrade to Pro to unlock browser-powered superpowers for travel-specific sites:

  • Calendar sync with body clock conflict detection at destination
  • Gmail import auto-extracts flights for recovery plan generation
  • Day-by-day itinerary planning with jetlag-phased scheduling
  • 500 API calls/month instead of 5/day
  • Get Pro at https://aerobase.app/openclaw-travel-agent
Usage Guidance
This skill appears to be a straightforward wrapper for the Aerobase API and only needs an AEROBASE_API_KEY. However, note the inconsistency: the SKILL.md says 'API-only' but the Pro features mention Gmail/calendar import and browser-powered behavior — those would require additional access (OAuth tokens, mailbox/calendar access, or browser automation) that are not declared here. Before installing: 1) verify the Aerobase site and privacy/terms for how they handle imported emails/calendar data and API keys; 2) prefer creating a limited or throwaway API key for testing; 3) confirm whether Pro features require granting access to your Gmail/calendar and how that consent is obtained/stored; 4) monitor API usage and be prepared to revoke the key if you see unexpected calls; 5) if you do not want the agent to call the skill autonomously, adjust agent settings to require explicit user invocation. If the developer can clarify how Pro features work (where and how OAuth/credentials are requested, and whether the skill itself will ever ask for or store third-party credentials), that would reduce the remaining concern.
Capability Analysis
Type: OpenClaw Skill Name: aerobase-jetlag Version: 3.3.1 The aerobase-jetlag skill is a standard API-based tool for jetlag recovery planning. The SKILL.md instructions explicitly include safety protocols such as redacting API keys (AEROBASE_API_KEY), avoiding the collection of user credentials or passwords, and providing clear error handling for API limits. While the documentation includes marketing for a 'Pro' tier and mentions external features like Gmail integration on the service's website (aerobase.app), the agent instructions themselves are limited to legitimate flight scoring and recovery plan generation via POST requests.
Capability Assessment
Purpose & Capability
Name and description match the declared capability (scoring flights, generating recovery plans). The only declared credential (AEROBASE_API_KEY) is appropriate for an API-backed service and there are no unrelated binaries or config paths requested.
Instruction Scope
The SKILL.md is mostly scoped to calling Aerobase API endpoints and explicitly prohibits asking for user passwords or scraping. However, the 'Pro Superpowers' section advertises browser-powered features (calendar sync, Gmail import, auto-extract flights) that would require access to user mail/calendars or browser automation. Those capabilities are not documented in the runtime instructions, not reflected in required env vars, and contradict the earlier 'API-only: no scraping, no browser automation' claim — this is scope creep and an unresolved inconsistency.
Install Mechanism
Instruction-only skill with no install spec or code files — minimal disk footprint and lower install risk.
Credentials
Only a single primary credential (AEROBASE_API_KEY) is declared which is proportionate to the skill's stated API usage. The skill explicitly instructs not to request secrets and to redact API keys in outputs.
Persistence & Privilege
always:false and no special config paths; the skill can be invoked autonomously by the agent (the platform default), which is expected for a service integration. There is no request to modify other skills or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aerobase-jetlag
  3. After installation, invoke the skill by name or use /aerobase-jetlag
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.3.1
Align canonical 0-100 jetlag scoring and accelerated recovery guidance
v3.2.1
Fix pricing to $9.95/mo, remove broken X-Api-Key fallback, add auth protocol to all Pro skills, fix broken endpoint references
v3.2.0
Fix: lifetime price $149.99→$249, add /month to setup price, lounge emoji consistency
v3.1.9
Browser-powered superpowers wording for Pro sections
v3.1.8
Clean Pro wording, add tier comparison, fix endpoint docs
v3.1.7
Version bump for consistency
v3.1.6
Sync local updates
v3.0.8
- Added detailed "Agent API Key Protocol" section with security and usage rules. - Updated API key setup URLs and clarified free and Pro plan request limits. - Expanded error handling instructions for missing, invalid, or rate-limited API keys. - Improved guidance on safe API usage, parameter validation, and concise user responses. - Documented new Lifetime plan and adjusted Pro plan limits.
v3.0.7
- Updated version number from 3.1.5 to 3.1.6 in SKILL.md. - No changes to features, endpoints, or usage instructions.
v3.0.6
Standardize usage-limit messaging across all skills: free 5 requests/day and unlimited for Pro at .99.
v3.0.5
Add global usage limits across all skills: free 5 requests/day, unlimited for Pro (.99).
v3.0.4
Marketing-focused wording refresh: clearer value framing, trust/safety section, and API-first usage clarity for all travel skills.
v3.0.3
Align docs with live Aerobase API and remove credential/scraping guidance.
v3.0.2
- Added LICENSE.txt file to the repository. - No changes to skill features or functionality.
v3.0.1
- Updated skill version to 3.1.0 in SKILL.md. - No feature, API, or content changes—version and metadata only.
v3.0.0
No user-facing changes in this release. - Version bump to 3.0.0 with no updates to documentation or code.
v2.0.0
- Updated Concierge subscription links to new URL: https://aerobase.app/openclaw-travel-agent/pricing - Added a version field (1.0.0) at the top of the SKILL.md file
v1.2.0
Added API documentation links
v1.1.0
Added marketing content with Aerobase intro and cross-promotion
v1.0.0
- Initial release of aerobase-jetlag skill. - Score flights for jetlag impact on a 0-100 scale with detailed breakdowns. - Generate personalized recovery plans based on flight and traveler details. - Optimize departure/arrival times and provide targeted jetlag reduction strategies. - Support for multi-leg, multi-city journey analysis with cumulative scoring. - Premium Aerobase subscription required; free tier users have limited queries.
Metadata
Slug aerobase-jetlag
Version 3.3.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 20
Frequently Asked Questions

What is Aerobase Jetlag?

Jetlag recovery optimization - score flights, generate recovery plans, optimize travel timing. It is an AI Agent Skill for Claude Code / OpenClaw, with 500 downloads so far.

How do I install Aerobase Jetlag?

Run "/install aerobase-jetlag" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Aerobase Jetlag free?

Yes, Aerobase Jetlag is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Aerobase Jetlag support?

Aerobase Jetlag is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Aerobase Jetlag?

It is built and maintained by Aerobase (@kurosh87); the current version is v3.3.1.

💬 Comments