Agent skill

Time Zone Planner

by aipoch in aipoch/medical-research-skills

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

MITAuto-check passed

Install Time Zone Planner

skills CLI
$ npx skills add aipoch/medical-research-skills --skill time-zone-planner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills time-zone-planner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-skills/Other/time-zone-planner .claude/skills/time-zone-planner && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
time-zone-planner
GitHub stars
2k
Token cost
~1.2k tokens
SKILL.md length
542 words
Files
6 (incl. scripts, references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Confirm the participant regions, meeting… → Check whether the request is for a quick… → Use the packaged script for baseline… → …
  • SKILL.md covers Quick Check, When to Use, Workflow and Usage, plus 9 more sections
  • Runs Python scripts from its folder; calls python

What it does

Time Zone Planner is an agent skill from aipoch/medical-research-skills. Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `POLISH_CHANGELOG.md`, `references/audit-reference.md` and `references/guidelines.md`).

The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

Example prompts

  • “/time-zone-planner”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Time Zone Planner loads about 1.2k tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 542 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 542 words, ~1,206 tokens.

Download SKILL.mdSave it as .claude/skills/time-zone-planner/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
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

Source: https://github.com/aipoch/medical-research-skills

Time Zone Planner

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

Quick Check

bash
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

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

Parameters

ParameterTypeRequiredDefaultDescription
regionslist[string]Yes—Region set, e.g. ["US/Eastern", "Europe/London", "Asia/Shanghai"]
durationintegerYes—Meeting duration in minutes
preferred_hoursobjectNo—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

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
Show full SKILL.md (217 more words)Show less

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.py fails, 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

Response Template

Use the following fixed structure for non-trivial requests:

  1. Objective
  2. Inputs Received
  3. Assumptions
  4. Workflow
  5. Deliverable
  6. Risks and Limits
  7. Next Checks

If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in scientific-skills/Other/time-zone-planner of aipoch/medical-research-skills.

  • SKILL.md
  • POLISH_CHANGELOG.md
  • references/audit-reference.md
  • references/guidelines.md
  • scripts/main.py
  • time-zone-planner_audit_result_v2.json

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Time Zone Planner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Time Zone Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Time Zone Planner this skillaipoch/medical-research-skills2k—~1.2kAutomated safety check: PassMIT
Meetingsalirezarezvani/claude-skills28k—~1.5kAutomated safety check: PassMIT
Plannerpenpot/penpot61k—~2.7kAutomated safety check: PassMPL-2.0
Launch Window Planneraaron-he-zhu/aaron-marketing-skills2.9k—~3kAutomated safety check: PassApache-2.0
Meeting Minutesgithub/awesome-copilot40k2 repos~2kAutomated safety check: PassMIT
Meeting Action ItemsNousResearch/hermes-agent252k—~950Automated safety check: PassMIT

Similar skills

  • Meetings

    alirezarezvani/claude-skills

    A skill your agent uses when someone wants to decide whether a meeting is worth calling, price a meeting in dollars, build a timeboxed agenda with desired outcomes, or turn messy meeting notes into…

    28k GitHub stars~1.5k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Planner

    penpot/penpot

    Read-only planning and architecture analysis — produce a structured implementation plan with task breakdown, acceptance criteria, sizing, and checkpoints.

    61k GitHub stars~2.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Launch Window Planner

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "pick a launch date", "plan the launch window", or "set the embargo and lift time"; produces a candidate-window comparison table (conflict / tailwind /…

    2.9k GitHub stars~3k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Meeting Minutes

    github/awesome-copilot

    Official

    Generate concise, actionable meeting minutes for internal meetings.

    40k GitHub starsUsed in 2 repos~2k tokens
    Productivity & AutomationAuto-check passed
  • Meeting Action Items

    NousResearch/hermes-agent

    Turn meeting notes into cited decisions, owners, tickets. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~950 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Meeting Notes

    outline/outline

    Create meeting notes in Outline from a template; use when the user wants an agenda, notes, or a follow-up document for a meeting.

    41k GitHub stars~551 tokensUpdated today
    Productivity & AutomationAuto-check passed

More from aipoch/medical-research-skills

All 567 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 21 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 21 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 21 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 21 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 21 days ago
    Auto-check passed

Questions about Time Zone Planner

What does Time Zone Planner do?

Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions. Time Zone Planner is an agent skill from aipoch/medical-research-skills. Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions.

How do I install Time Zone Planner in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill time-zone-planner -a claude-code`. Or copy the skill folder (scientific-skills/Other/time-zone-planner in aipoch/medical-research-skills) into .claude/skills/time-zone-planner in your project. Claude Code loads it when a task matches its description.

How do I install Time Zone Planner in Codex?

Run `npx skills add aipoch/medical-research-skills --skill time-zone-planner -a codex`. Or copy the skill folder (scientific-skills/Other/time-zone-planner in aipoch/medical-research-skills) into .agents/skills/time-zone-planner in your project. Codex loads it when a task matches its description.

Can I use Time Zone Planner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill time-zone-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/time-zone-planner, .gemini/skills/time-zone-planner, .github/skills/time-zone-planner and .opencode/skills/time-zone-planner in your project.

What does Time Zone Planner need to run?

Going by SKILL.md and its folder, Time Zone Planner needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Time Zone Planner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Time Zone Planner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Time Zone Planner use?

Time Zone Planner is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Time Zone Planner use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 264 tokens, read only when the agent opens those files.

What are the alternatives to Time Zone Planner?

Skills that share tags, products or a category with Time Zone Planner: Meetings (alirezarezvani/claude-skills, 28k stars), Planner (penpot/penpot, 61k stars), Launch Window Planner (aaron-he-zhu/aaron-marketing-skills, 2.9k stars) and Meeting Minutes (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Time Zone Planner?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,974 GitHub stars. The repository holds 567 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.