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.
Install / Use
npx skills add aipoch/medical-research-skills --skill time-zone-plannerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Education & ResearchSupported Platforms
Our assessment of time-zone-planner
time-zone-planner scores 88/100 on our quality scale, 219th of 421 Education & Research skills we index.
Its SKILL.md is 4.7 KB long, well organised into 15 sections with 2 code examples: a solid amount of guidance for an agent.
With 1,916 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so time-zone-planner is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
time-zone-planner compared with similar skills
All 4 of these similar skills score higher than time-zone-planner; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| time-zone-planner (this skill)by aipoch | 88 | 1.9k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| last30days-skillby mvanhorn | 100 | 68.0k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install time-zone-planner?
- Run
npx skills add aipoch/medical-research-skills --skill time-zone-planner. The install tabs above show the steps for each supported agent. - Which AI agents does time-zone-planner work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is time-zone-planner safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is time-zone-planner still maintained?
- The repository was last updated about 2 months ago, so time-zone-planner is actively maintained.
Skill content
View source on GitHubname: time-zone-planner description: Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions. license: MIT author: AIPOCH
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
- Confirm the participant regions, meeting duration, preferred local-hour ranges, and any hard constraints.
- Check whether the request is for a quick overlap recommendation or a full tradeoff analysis.
- Use the packaged script for baseline scheduling output; for complex requests, provide a manual comparison table with stated assumptions.
- Return suggested meeting windows, region-by-region local times, and the tradeoffs behind the recommendation.
- 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
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| regions | list[string] | Yes | — | Region set, e.g. ["US/Eastern", "Europe/London", "Asia/Shanghai"] |
| duration | integer | Yes | — | Meeting duration in minutes |
| preferred_hours | object | No | — | Per-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
| Alias | Mapped To | Note |
|-------|-----------|------|
| US | US/Eastern | Representative only; specify sub-region for accuracy |
| EU | Europe/London | Representative only; specify country for accuracy |
| Asia | Asia/Shanghai | Representative 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:
- Assumptions
- Hard Constraints
- Recommended Window
- Tradeoffs
- Risks and Manual Checks
Error Handling
- If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
- If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
- If
scripts/main.pyfails, report the failure point, summarize what still can be completed safely, and provide a manual fallback. - Do not fabricate live calendar availability or confirmed participant agreement.
Input Validation
This skill accepts: a list of participant regions and a meeting duration for cross-timezone scheduling recommendations.
If the request does not involve cross-timezone meeting planning — for example, asking to book calendar events, check live availability, make travel arrangements, or provide legal scheduling advice — do not proceed with the workflow. Instead respond:
"time-zone-planner is designed to recommend meeting windows across time zones for distributed teams. Your request appears to be outside this scope. Please provide a region list and meeting duration, or use a more appropriate tool."
References
- references/guidelines.md — General time-zone planning notes
- references/audit-reference.md — Supported scope, audit commands, and fallback boundaries
Response Template
Use the following fixed structure for non-trivial requests:
- Objective
- Inputs Received
- Assumptions
- Workflow
- Deliverable
- Risks and Limits
- Next Checks
If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
last30days-skill
68.0kAI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
