ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

time-zone-planner

Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/aipoch-ai/time-zone-planner
Or

Time Zone Planner

Structured cross-time-zone meeting planning for distributed teams.

Quick Check

python -m py_compile scripts/main.py
python scripts/main.py

When to Use

  • Use this skill when planning meeting windows across multiple regions or time zones.
  • Use this skill when comparing candidate windows and tradeoffs for distributed team scheduling.
  • Do not use this skill for calendar booking, live availability checking, or travel/legal decisions.

Workflow

  1. Confirm the participant regions, meeting duration, preferred local-hour ranges, and any hard constraints.
  2. Check whether the request is for a quick overlap recommendation or a full tradeoff analysis.
  3. Use the packaged script for baseline scheduling output; for complex requests, provide a manual comparison table with stated assumptions.
  4. Return suggested meeting windows, region-by-region local times, and the tradeoffs behind the recommendation.
  5. If timezone details or availability constraints are missing, stop and request the minimum missing fields.

Usage

python scripts/main.py
# Input: {"regions": ["US", "EU", "Asia"], "duration": 60}

Parameters

ParameterTypeRequiredDefaultDescription
regionslist[string]YesRegion set, e.g. ["US/Eastern", "Europe/London", "Asia/Shanghai"]
durationintegerYesMeeting duration in minutes
preferred_hoursobjectNoPer-region preferred local hour ranges, e.g. {"US/Eastern": [9, 17]}

Region format: Use IANA timezone names (e.g., US/Eastern, Europe/London, Asia/Shanghai) for precise mapping. Short aliases like "US" or "EU" are accepted but will be mapped to a representative timezone with a note.

Region Alias Mapping

AliasMapped ToNote
USUS/EasternRepresentative only; specify sub-region for accuracy
EUEurope/LondonRepresentative only; specify country for accuracy
AsiaAsia/ShanghaiRepresentative only; specify city for accuracy

Output

  • Suggested meeting windows by region
  • Local-time mapping for each included region
  • DST assumption notes when applicable
  • Tradeoff summary for each candidate window

Scope Boundaries

  • This skill supports scheduling recommendations, not calendar booking.
  • This skill does not validate current DST status from live internet sources.
  • This skill does not decide business priority between teams without user-supplied rules.
  • Manual confirmation is required before sending invites.

Stress-Case Rules

For multi-constraint requests, always include these explicit blocks:

  1. Assumptions
  2. Hard Constraints
  3. Recommended Window
  4. Tradeoffs
  5. Risks and Manual Checks

Error Handling

Metadata

Author@aipoch-ai
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-aipoch-ai-time-zone-planner": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.