MCPInstall

timezone-awareness

When the user wants to build or improve a sales bot's ability to respect prospect time zones for outreach. Also use when the user mentions "timezone," "local time," "send time optimization," "time-based outreach," or "international outreach."

Installs
418
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/louisblythe/sales-skills --skill timezone-awareness
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads timezone-awareness automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Timezone Awareness

You are an expert in building sales bots that respect prospect time zones and optimize send times. Your goal is to help developers create systems that reach prospects at the right moment, regardless of where they are in the world.

Why Timezone Matters

The Wrong Time Problem

Your bot is in EST. Prospect is in Sydney.
You send at 9am EST = 1am Sydney.

Result:
- Message buried by morning
- Lower open rates
- Appears tone-deaf
- Damages brand perception

"Why are they emailing me at 1am?"

The Right Time Advantage

Same scenario, timezone-aware:
You send at 9am Sydney time.

Result:
- Top of inbox
- Higher open rates
- Appears professional
- Feels personalized

"They actually know what time it is here."

Timezone Detection

From Phone Number

Phone number: +61 2 9999 9999
+61 = Australia
02 = Sydney/NSW area code
Timezone: Australia/Sydney (AEST/AEDT)

Phone number: +1 415 555 1234
+1 = USA/Canada
415 = San Francisco area code
Timezone: America/Los_Angeles (PST/PDT)

Mapping:
- Extract country code
- For large countries (US, CA, AU), use area code
- Map to IANA timezone identifier

From Email Domain

Email: john@company.com.au
TLD: .com.au = Australia
Default: Australia/Sydney

Email: contact@company.de
TLD: .de = Germany
Default: Europe/Berlin

Email: john@company.com
→ Need additional signals (IP, phone, address)

From Company Data

Company headquarters: San Francisco, CA
→ America/Los_Angeles

Company website shows UK address
→ Europe/London

LinkedIn shows "Based in Singapore"
→ Asia/Singapore

Priority:
1. Explicit timezone in data
2. Phone area code
3. Company headquarters
4. Email TLD
5. IP geolocation (least reliable)

From Explicit Input

Always allow prospect to state preference:

"When's a good time to chat?"
"Mornings work best, I'm in Chicago."
→ Parse and store: America/Chicago, morning preference

Forms:
[Select your timezone ▼]
→ Store as provided

Optimal Send Windows

Universal Best Times

General guidelines (in prospect's local time):

Email:
- Best: Tuesday-Thursday, 9-11am, 2-4pm
- Good: Monday 10am+, Friday before 2pm
- Avoid: Monday before 10am, Friday after 2pm
- Never: Saturday-Sunday (most industries)

SMS:
- Best: Tuesday-Thursday, 10am-12pm, 2-5pm
- Avoid: Before 9am, after 8pm
- Never: Before 8am, after 9pm (compliance)

Phone:
- Best: Tuesday-Thursday, 10-11:30am, 2-4pm
- Good: Right after lunch (1-2pm)
- Avoid: Monday morning, Friday afternoon

Industry Adjustments

B2B Enterprise:
- Email: 8-10am (catch before meetings)
- Calls: 7:30-8:30am (executives available early)

Retail/E-commerce:
- Avoid holiday seasons
- Weekend outreach may work

Healthcare:
- Early morning or after 6pm (practitioners)
- Avoid clinic hours

Startups/Tech:
- Later mornings (10am+)
- Avoid very early (culture tends late)

Finance:
- Very early (6-8am) can work
- Avoid month/quarter end

Personal Patterns

Learn individual preferences:

Track:
- When do they open emails?
- When do they respond?
- When are calls answered?

Adapt:
- Opens emails at 7am? Send at 6:45am.
- Responds at night? Send EOD.
- Answers calls at lunch? Call at 12:30.

"Send when THEY engage, not when you assume."

Implementation

Storing Timezone Data

{
  "prospect_id": "12345",
  "timezone": {
    "iana": "America/New_York",
    "offset_hours": -5,
    "observes_dst": true,
    "current_offset": -5,
    "detection_method": "phone_area_code",
    "confidence": "high"
  },
  "preferences": {
    "preferred_time": "morning",
    "avoid_days": ["Friday"],
    "stated_by_prospect": true
  },
  "engagement_patterns": {
    "typical_open_hour": 9,
    "typical_response_hour": 14,
    "most_active_day": "Tuesday"
  }
}

Send Time Calculation

def calculate_send_time(prospect, message_type):
    tz = get_prospect_timezone(prospect)

    # Get optimal window for message type
    if message_type == "email":
        windows = [(9, 11), (14, 16)]  # 9-11am, 2-4pm
    elif message_type == "sms":
        windows = [(10, 12), (14, 17)]  # 10am-12pm, 2-5pm
    else:
        windows = [(10, 11.5), (14, 16)]  # Phone

    # Apply individual patterns if available
    if prospect.engagement_patterns:
        preferred_hour = prospect.engagement_patterns.typical_open_hour
        windows = [(preferred_hour, preferred_hour + 1)] + windows

    # Find next available window
    now_local = now_in_timezone(tz)

    for window_start, window_end in windows:
        send_time = next_occurrence(now_local, window_start)
        if is_valid_day(send_time, message_type):
            return send_time

    # Default: next business day, first window
    return next_business_day(now_local, windows[0][0])

Handling Edge Cases

def validate_send_time(send_time, prospect, message_type):
    local_time = to_local(send_time, prospect.timezone)

    # Hard limits (legal/compliance)
    if message_type == "sms":
        if local_time.hour < 8 or local_time.hour >= 21:
            return defer_to_next_valid_time(local_time)

    # Soft limits (best practice)
    if local_time.hour < 7 or local_time.hour >= 20:
        return defer_to_next_valid_time(local_time)

    # Weekend handling
    if local_time.weekday() >= 5:  # Saturday or Sunday
        if not prospect.industry_allows_weekend:
            return defer_to_monday(local_time)

    # Holiday handling
    if is_holiday(local_time.date(), prospect.country):
        return defer_to_next_business_day(local_time)

    return send_time

Multi-Timezone Campaigns

Batch Scheduling

Campaign to 1000 prospects across 10 timezones:

Wrong approach:
→ Send all at once at 9am your time
→ Some get it at 6am, others at midnight

Right approach:
→ Group by timezone
→ Schedule each group for 9am local
→ Sends roll out over 24 hours

Implementation:
1. Group prospects by timezone
2. Calculate send time per group
3. Schedule batches
4. Stagger to avoid delivery issues

Real-Time Messaging

For synchronous channels (chat, SMS responses):

If prospect messages at 2am your time:
→ Is it business hours for them?
→ Yes: Respond (bot or human handoff)
→ No: They're night owl, respond anyway

For scheduled messages:
→ Always use their timezone
→ Queue until appropriate window

Global Team Coordination

Sales team across timezones:

Prospect in Tokyo, Rep in New York:
→ Bot handles initial outreach at Tokyo optimal time
→ Bot manages async conversation
→ Schedules call for overlap window
→ Hands off to rep with context

Finding overlap:
- Tokyo: 9am-6pm JST
- New York: 9am-6pm EST
- Overlap: 10pm-12am JST = 8-10am EST
→ Schedule calls in overlap window

Daylight Saving Time

DST Handling

Critical: Use IANA timezone IDs, not offsets.

Wrong: Store "UTC-5"
→ Half the year it's UTC-4 (DST)

Right: Store "America/New_York"
→ System handles DST automatically

DST transition handling:
- Check if DST change is upcoming
- Recalculate scheduled sends
- Avoid scheduling exactly at transition hour

DST-Affected Regions

Observes DST:
- USA (most), Canada (most)
- Europe
- Australia (some states)
- New Zealand
- Parts of South America

Does NOT observe DST:
- Most of Asia
- Most of Africa
- Arizona, Hawaii (USA)
- Queensland (Australia)

Always check current rules—they change.

Compliance Considerations

TCPA (USA)

SMS/Voice calls:
- Not before 8am local time
- Not after 9pm local time
- Applies to recipient's timezone
- Document timezone determination

Penalties: $500-$1500 per violation

ACMA (Australia)

Telemarketing:
- Weekdays: 9am-8pm local
- Saturdays: 9am-5pm local
- Sundays/holidays: Prohibited

SMS similar restrictions apply.

GDPR (Europe)

No specific time restrictions, but:
- Consent still required
- Reasonable expectations apply
- 3am emails look suspicious
- Best practice: 8am-8pm local

General Best Practice

Regardless of legal requirements:

Safe window:
- 9am-6pm local time
- Monday-Friday
- Avoid local holidays

Extended window (if needed):
- 8am-8pm local time
- Include Saturday cautiously

Never:
- Before 8am local
- After 9pm local
- On local major holidays

User Experience

Communicating Timezone Awareness

Show the prospect you know their timezone:

"Good morning from Sydney!"
(When it's morning there)

"I know it's late in London, so no rush—
whenever you have a moment."
(When sending EOD their time)

"Happy to chat—I'm flexible since I know
we're 12 hours apart. What works for you?"
(Acknowledging the gap)

Letting Prospects Choose

Always provide escape valve:

"I'll follow up Thursday at 10am your time.
If that doesn't work, let me know what's better."

Calendar links:
→ Auto-detect timezone
→ Show times in their local zone
→ Let them pick

Preference capture:
"For future reference, is morning or afternoon
better for you?"

Testing & Monitoring

Timezone Testing

Test cases:
- Prospect in your timezone (same day)
- Prospect 12 hours ahead (different day)
- Prospect in DST transition
- Prospect in non-DST region
- Unknown timezone prospect

Verify:
- Send time correct in all cases
- No messages outside safe window
- Holiday handling works
- DST transitions handled

Monitoring Metrics

Track by timezone:
- Open rates
- Response rates
- Opt-out rates
- Spam complaints

Look for:
- Timezone with poor metrics (wrong detection?)
- Patterns by send hour
- Weekend vs weekday performance

Optimize:
- Adjust send windows per timezone
- Identify timezone-specific preferences
- Fix detection issues

Error Handling

When timezone unknown:

Default strategy:
1. Use company headquarters timezone
2. Or: Assume business hours in most likely region
3. Send at safe middle time (2pm UTC = safe for Americas/Europe)

Flag for enrichment:
- Mark "timezone_confidence: low"
- Attempt to enrich from other sources
- Watch engagement patterns for hints

FAQ

What does the timezone-awareness skill do?

When the user wants to build or improve a sales bot's ability to respect prospect time zones for outreach. Also use when the user mentions "timezone," "local time," "send time optimization," "time-based outreach," or "international outreach."

How do I install timezone-awareness?

Run npx skills add https://github.com/louisblythe/sales-skills --skill timezone-awareness in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/timezone-awareness/ (personal) or .claude/skills/timezone-awareness/ (project).

Which AI agents can use timezone-awareness?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is timezone-awareness safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains timezone-awareness?

It is published by louisblythe in louisblythe/sales-skills. It has 418 recorded installs.

More from louisblythe/sales-skills

View all →

appointment-booking

louisblythe/sales-skills

When the user wants to build or improve a sales bot's ability to integrate with calendars and schedule meetings autonomously. Also use when the user mentions "booking meetings," "calendar integration," "scheduling calls," "appointment setting," or "automated booking."

Business & Finance884 installs

objection-handling

louisblythe/sales-skills

When the user wants to improve their ability to address prospect concerns, overcome resistance, or respond to pushback without being defensive. Also use when the user mentions "handling objections," "overcoming resistance," "common objections," "prospect pushback," "they said no," or "dealing with concerns."

Business & Finance618 installs

sales-presentations

louisblythe/sales-skills

When the user wants to create, optimize, or improve sales presentations, pitch decks, demos, or proposal presentations. Also use when the user mentions "sales deck," "pitch deck," "demo presentation," "proposal deck," "investor pitch," "executive presentation," "sales slides," "presentation optimization," or "how to present." This skill covers structuring, designing, and delivering compelling sales presentations.

Business & Finance580 installs

outbound-prospecting

louisblythe/sales-skills

When the user wants help with outbound sales prospecting, lead sourcing, or pipeline building. Also use when the user mentions 'prospecting,' 'lead sourcing,' 'finding leads,' 'building pipeline,' 'cold outreach,' 'target account list,' 'ICP,' 'buyer persona,' 'lead list,' or 'account-based.' This skill covers prospecting strategy, lead research, multi-channel outreach, and pipeline generation.

Business & Finance534 installs

closing

louisblythe/sales-skills

When the user wants to improve their ability to recognize buying signals, ask for the sale, and confidently move deals to commitment. Also use when the user mentions "closing deals," "asking for the sale," "getting commitment," "buying signals," "sealing the deal," or "converting prospects."

Business & Finance527 installs

sales-psychology

louisblythe/sales-skills

When the user wants to apply psychological principles to sales conversations, understand buyer behavior, or use persuasion techniques ethically. Also use when the user mentions 'buyer psychology,' 'why people buy,' 'persuasion,' 'influence,' 'decision-making,' 'cognitive bias,' or 'negotiation psychology.' This skill provides 70+ mental models organized for sales application.

Business & Finance513 installs

Popular business & finance skills

View category →

sales-enablement

coreyhaines31/marketingskills

When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'battle card,' 'battlecard,' 'competitive one-pager,' 'win-loss analysis,' 'why are we losing deals,' 'loss reasons,' 'how do I respond to this objection,' 'prospect just said,' 'help my sales team,' 'sales materials,' or 'what should I give my sales reps,' 'cold call script,' or 'voicemail script.' Use this for any document or asset that helps a sales team close deals. For public competitor comparison pages, see competitors. For running buyer interviews or churn research, see customer-research. For marketing website copy, see copywriting. For cold outreach emails, see cold-email. For the offer being sold (bonuses, guarantees, pricing structure),

Business & Finance119.5K installs

revops

coreyhaines31/marketingskills

When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'outbound pipeline stages,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should marketing hand off to sales.' Use this for anything involving the systems and processes that connect marketing to revenue. For cold outreach emails, see cold-email. For email drip campaigns, see emails. For pricing decisions, see pricing.

Business & Finance114.1K installs

sales-funnel-blueprint

autonnel/autonnel-skills

Turn an offer into a concrete multi-step sales funnel spec - page-by-page structure, price ladder, copy outline and the metrics each step must hit. Use when asked to build a sales funnel, marketing funnel, landing page flow, lead magnet funnel, webinar funnel, tripwire or VSL funnel, when planning a product launch page flow, or when someone asks "what pages do I need" for selling something online.

Business & Finance104.5K installs

pricing

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' 'should I offer a free plan,' 'pricing page teardown,' 'pricing page audit,' 'is my pricing page AI-readable,' or 'can AI read my pricing.' Use this whenever someone is figuring out what to charge, how to structure their plans, or wants to audit a pricing page (for humans and for the AI agents that shortlist tools). For in-app upgrade screens, see paywalls. For offer construction (bonuses, guarantees, value framing, naming) on services/courses/coaching/high-ticket B2B, see offers.

Business & Finance80K installs

cross-border-ecommerce

nexscope-ai/ecommerce-skills

Cross-border e-commerce expansion advisor. Scores target markets on 8 weighted dimensions (market size, ecommerce penetration, competition, regulatory complexity, logistics infrastructure, payment ecosystem, cultural distance, IP protection), compares 5 fulfillment models with cost and transit data, provides country-by-country tax/duty compliance guides (EU VAT/IOSS, UK VAT, US sales tax, CA GST, AU GST, JP consumption tax), maps local payment preferences by market, and builds a phased expansion roadmap. No API key required.

Business & Finance62.9K installs

pricing-strategy

coreyhaines31/marketingskills

When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' or 'should I offer a free plan.' Use this whenever someone is figuring out what to charge or how to structure their plans. For in-app upgrade screens, see paywall-upgrade-cro.

Business & Finance61.2K installs