| name | weather |
| description | This skill should be used when the user wants to check the weather, view forecasts, check temperature or conditions for a city, use the weather map, manage saved cities, check air quality, wind, UV index, humidity, or interact with the Weather app on their iPhone. |
iOS Weather App — Usage Manual
The Apple Weather app displays current conditions, forecasts, and detailed weather data for saved cities. This skill teaches you the Weather app's UI layout and interaction patterns.
Always take a screenshot after each action to verify what's on screen. Use visual landmarks (text labels, icons, positions like "top-left") rather than memorized coordinates.
TapKit Setup Reminder
Before acting in this app, follow the core TapKit setup: list_phones() -> choose phone_id -> get_phone_status(phone_id). All TapKit examples in this skill assume every MCP tool call includes that phone_id.
App Structure Overview
The Weather app has three main views:
- City Detail View — The main scrollable weather view for a single city
- City List View — A list of all saved cities with summary weather info
- Full-Screen Map View — An interactive weather map with multiple data layers
Bottom Toolbar (persistent on City Detail View)
| Element | Position | Action |
|---|
| Map icon | Bottom-left (~75, 1270) | Opens the full-screen weather map |
| Page dots | Bottom-center (~310, 1270) | Indicates which city you're viewing; swipe left/right to switch |
| List icon | Bottom-right (~548, 1270) | Opens the city list view |
City Detail View
The primary view shown when you open the app. A single vertically-scrollable page with multiple sections. Background dynamically reflects current weather conditions.
Opening the App
open_app("Weather")
Header Section (top, no scrolling needed)
- City name: Large text, centered (e.g., "New York")
- Current temperature: Very large text below city name (e.g., "45°")
- Feels Like: Below current temp (e.g., "Feels Like: 35°")
- High / Low: Below feels like (e.g., "H:51° L:37°")
When scrolled down, the header collapses to a sticky bar showing: City Name / Temp° | Feels Like: Temp°
Forecast Summary
A brief natural-language summary of the forecast (e.g., "Higher temperatures expected tomorrow, with a high of 70°.").
Hourly Forecast
- Horizontally scrollable row of hourly forecasts
- Each entry: Time, Weather icon, Temperature
- Starts with "Now" and extends ~12+ hours
- Swipe left on the row to see more hours
10-Day Forecast
- Section header: "10-DAY FORECAST" with calendar icon
- Each row: Day name, Weather icon (with precipitation % in cyan if applicable), Low temp, Color-coded temperature bar, High temp
- Tapping any day opens the detailed Conditions modal
Air Quality
- Section header: "AIR QUALITY"
- Shows: AQI number, Rating (e.g., "Moderate"), Color-coded gradient bar, Description text
Wind Map (inline preview)
- Embedded map showing animated wind patterns
- Shows saved cities with wind speed indicators
- Tapping opens the full-screen map view
Weather Widgets (scrollable sections)
| Order | Widget | Width |
|---|
| Feels Like | Half (left) | |
| UV Index | Half (right) | |
| Wind | Full | |
| Sunrise/Sunset | Half (left) | |
| Precipitation | Half (right) | |
| Visibility | Half (left) | |
| Humidity | Half (right) | |
| Moon Phase | Full | |
| Averages | Half (left) | |
| Pressure | Half (right) | |
All widgets are tappable — each opens a detailed Conditions modal.
Navigating Between Cities
- Swipe left on the detail view to go to the next city
- Swipe right to go to the previous city
- Page dots at the bottom indicate which city is shown
City List View & City Management
Access by tapping the list icon (bottom-right, ~548, 1270).
Layout
- "Weather" header at top-left
- Three-dot menu (⋯) at top-right (~556, 95)
- City cards: Each shows city name, local time, forecast summary, current temperature, H/L
- Search bar at bottom: "Search for a city or airport" (~310, 1237)
Three-Dot Menu (⋯)
| Option | Description |
|---|
| Edit List | Reorder or delete saved cities |
| Notifications | Configure weather alerts |
| Celsius | Switch to Celsius |
| Fahrenheit | Switch to Fahrenheit |
| Units | Configure all measurement units |
| Report an Issue | Report weather data problems |
Adding a City
copy_text_to_phone("San Francisco") to load the city name onto the clipboardlong_press(260, 1238, duration: 1500) on the search bar at the bottom — this activates the field and shows the Paste tooltip- Tap "Paste" in the tooltip
- Results appear as live auto-complete — tap to select
- City detail view opens — tap "Add" (top-right) to save
Deleting a City
Method 1 — Swipe-to-delete:
- Swipe left on a city card
- Tap the red trash can button that appears
Method 2 — Edit List mode:
- ⋯ menu → Edit List
- Tap red minus button on left of city card
- Tap trash button to confirm
- Tap checkmark to exit edit mode
Reordering Cities
- ⋯ menu → Edit List
- Use
hold_and_drag() on drag handles (≡) to reorder
- Tap checkmark to exit
Units Settings
Access: ⋯ menu → Units
| Unit | Default | Options |
|---|
| Temperature | System setting | Celsius (°C), Fahrenheit (°F), Use system setting |
| Wind | mph | mph, km/h, m/s, bft, kn |
| Precipitation | in | Inches, Millimeters/centimeters |
| Pressure | inHg | mbar, inHg, mmHg, hPa, kPa |
| Distance | mi | Miles, Kilometers |
Full-Screen Map View
Access by tapping map icon (bottom-left, ~75, 1270).
Layout
- X button (top-left, ~50, 110) — closes map
- Layer selector (top-right, ~572, 107) — switch map layers
- Location button (~572, 160) — center on current location
Map Layers
| Layer | What it Shows |
|---|
| Precipitation | Rain/snow patterns with intensity |
| Temperature | Heat map of temperatures |
| Air Quality | AQI levels across region |
| Wind | Animated wind flow lines (default) |
Timeline Controls (bottom of map)
- Play button (▶) — animate weather data forward
- Time scrubber — drag to scrub through hours
Conditions Detail Modal
Access by tapping any day in the 10-Day Forecast or any detail widget.
- Day selector: Scrollable horizontal row of dates
- Condition type dropdown: Switch between Conditions, UV Index, Wind, Precipitation, Humidity, Visibility, Pressure
- 24-hour chart with hourly values, color-coded area/line chart
- Additional sections: Chance of Precipitation, Precipitation Totals, Forecast text, Daily Comparison
Key Workflows
Check Current Weather
1. open_app("Weather") → screenshot to verify
2. City detail view shows current temp, feels like, H/L
Get the 10-Day Forecast
1. open_app("Weather")
2. swipe(310, 672, "up") — scroll past hourly to 10-day section
3. screenshot
Check if it Will Rain
1. Look for precipitation % on 10-day forecast (cyan text like "90%")
2. Or scroll down ~3 swipes to find the Precipitation widget
3. Tap a day to see detailed Precipitation chart
Switch Between Cities
# Option 1: Swipe on detail view
swipe(310, 672, "left") # Next city
swipe(310, 672, "right") # Previous city
# Option 2: Use city list
tap(548, 1270) # List icon
screenshot # See all cities
tap(310, 210) # Tap desired city card
Add a New City
1. tap(548, 1270) # Open city list
2. copy_text_to_phone("San Francisco") # Load city name onto clipboard
3. long_press(260, 1238, duration: 1500) # Activate search bar, show Paste tooltip
4. Tap "Paste" in the tooltip
5. Tap result from auto-complete
6. Tap "Add" (top-right) to save
Open the Weather Map
1. tap(75, 1270) # Map icon
2. screenshot
3. tap(572, 107) # Layer selector to switch layers
Change Temperature Units
1. tap(548, 1270) # List icon to go to city list
2. tap(556, 95) # Three-dot menu
3. Tap "Celsius" or "Fahrenheit"
Tips and Gotchas
- Background adapts to weather: Cloudy skies show dark backgrounds, sunny days are brighter. This affects text readability in screenshots.
- Typing into the search field: Use the clipboard paste flow (
copy_text_to_phone → long_press the search bar at 1500ms → tap "Paste" in the tooltip). Don't try to tap individual keyboard keys.
- Precipitation percentage: Shown in cyan/teal text below weather icon in the 10-day forecast when rain is expected.
- "My Location": If location services are enabled, the first city may show "My Location" instead of a city name.
- All detail widgets are tappable: Every section on the main view can be tapped to open a detailed chart/modal.
- Half-width widgets are arranged in a 2-column grid.
- Scrolling: Swipe up to scroll down. ~4 swipes from top reaches the bottom of the detail view.
- Health Information banner: May occasionally appear as a popup — dismiss by tapping X.
