Earthquake Watch Skill
"Did we just have an earthquake?" gets asked within seconds of every tremor, and the USGS answers globally in near-real-time over keyless HTTPS. This skill knows the feed matrix (magnitude threshold × time window), filters to the place actually asked about, and frames magnitudes honestly — a 4.5 under a city and a 6.0 under the ocean are different events, and depth is half the story. For anything safety-shaped, it points at official emergency guidance rather than improvising any.
What This Skill Produces
- The events — matching quakes with magnitude, depth, location, and time (converted to the user's zone)
- The context read — what that magnitude/depth typically means for feeling it and damage, as bands not predictions
- The regional filter — the feed is global; the answer is about the place asked
- The command — exact curl, rerunnable
Required Inputs
Ask for these if not provided:
- Where — a place to filter around (the feeds are global; lat/lon of the place makes distance filtering honest)
- The window — "just now" (past hour feed), today, this week
- The threshold — significant-only vs. everything-they-can-feel (M2.5+) vs. research-grade (all)
Framework: The Feed Matrix and the Framing
- The feeds —
https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/{mag}_{window}.geojson where mag ∈ significant, 4.5, 2.5, 1.0, all and window ∈ hour, day, week, month. "Just felt something" → 2.5_hour; "big ones today" → 4.5_day. Each feature: properties.mag, .place, .time (epoch ms), .url (event page), geometry.coordinates = [lon, lat, depth km].
- Targeted queries beat feed-filtering for specific regions:
https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&latitude=35.68&longitude=139.69&maxradiuskm=300&starttime=2026-07-17&minmagnitude=3 — the fdsnws endpoint takes radius, time, magnitude bounds directly.
- Magnitude bands, stated with every event: <3 rarely felt · 3–4 felt, no damage · 4–5 felt widely, minor damage possible near epicenter · 5–6 damage possible in built-up areas · 6–7 serious damage potential · 7+ major. Depth modifies everything: a shallow (<20km) M5 outfeels a 200km-deep M6 — say both numbers together.
- Times get converted: feed times are epoch UTC; the answer speaks the user's local time ("14 minutes ago, 03:12 local").
- The safety line: for "should I worry / is a bigger one coming" — aftershock probabilities and tsunami assessments belong to official agencies; link the event's USGS page and name the authoritative sources (national geological survey, tsunami warning centers) instead of improvising reassurance or alarm.
Output Format
Earthquakes: [region] — [window]
[The direct answer: "Yes — M4.7, 22km deep, 38km NE of [place], 14 min ago" or "No M2.5+ events near [place] in the past [window]."]
| Time (local) |
Mag |
Depth |
Location |
USGS link |
[Context band for the notable event(s) · aftershock/official-guidance line when safety is in the air]
Source: USGS real-time feeds · rerun: [exact curl]
Informational — for safety decisions follow official emergency guidance, not this summary.
Quality Checks
Anti-Patterns
1---2name: earthquake-watch3description: Check recent earthquakes worldwide with zero API keys — USGS real-time GeoJSON feeds via curl, filtered by magnitude, region, and time window. Use when asked was there an earthquake just now, recent quakes near a place, any big earthquakes today, or monitor seismic activity somewhere. Produces the matching events with magnitude, depth, location and time, the felt/damage context bands, and the rerunnable command — with the official-guidance line safety questions require.4---5
6# Earthquake Watch Skill
7
8"Did we just have an earthquake?" gets asked within seconds of every tremor, and the USGS answers globally in near-real-time over keyless HTTPS. This skill knows the feed matrix (magnitude threshold × time window), filters to the place actually asked about, and frames magnitudes honestly — a 4.5 under a city and a 6.0 under the ocean are different events, and depth is half the story. For anything safety-shaped, it points at official emergency guidance rather than improvising any.
9
10## What This Skill Produces
11
12- **The events** — matching quakes with magnitude, depth, location, and time (converted to the user's zone)
13- **The context read** — what that magnitude/depth typically means for feeling it and damage, as bands not predictions
14- **The regional filter** — the feed is global; the answer is about the place asked
15- **The command** — exact curl, rerunnable
16
17## Required Inputs
18
19Ask for these if not provided:
20- **Where** — a place to filter around (the feeds are global; lat/lon of the place makes distance filtering honest)
21- **The window** — "just now" (past hour feed), today, this week
22- **The threshold** — significant-only vs. everything-they-can-feel (M2.5+) vs. research-grade (all)
23
24## Framework: The Feed Matrix and the Framing
25
261. **The feeds** — `https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/{mag}_{window}.geojson` where mag ∈ `significant`, `4.5`, `2.5`, `1.0`, `all` and window ∈ `hour`, `day`, `week`, `month`. "Just felt something" → `2.5_hour`; "big ones today" → `4.5_day`. Each feature: `properties.mag`, `.place`, `.time` (epoch ms), `.url` (event page), `geometry.coordinates` = [lon, lat, **depth km**].
272. **Targeted queries beat feed-filtering for specific regions:** `https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&latitude=35.68&longitude=139.69&maxradiuskm=300&starttime=2026-07-17&minmagnitude=3` — the fdsnws endpoint takes radius, time, magnitude bounds directly.
283. **Magnitude bands, stated with every event:** <3 rarely felt · 3–4 felt, no damage · 4–5 felt widely, minor damage possible near epicenter · 5–6 damage possible in built-up areas · 6–7 serious damage potential · 7+ major. **Depth modifies everything:** a shallow (<20km) M5 outfeels a 200km-deep M6 — say both numbers together.
294. **Times get converted:** feed times are epoch UTC; the answer speaks the user's local time ("14 minutes ago, 03:12 local").
305. **The safety line:** for "should I worry / is a bigger one coming" — aftershock probabilities and tsunami assessments belong to official agencies; link the event's USGS page and name the authoritative sources (national geological survey, tsunami warning centers) instead of improvising reassurance or alarm.
31
32## Output Format
33
34# Earthquakes: [region] — [window]
35
36**[The direct answer: "Yes — M4.7, 22km deep, 38km NE of [place], 14 min ago" or "No M2.5+ events near [place] in the past [window]."]**
37
38| Time (local) | Mag | Depth | Location | USGS link |
39|---|---|---|---|---|
40
41[Context band for the notable event(s) · aftershock/official-guidance line when safety is in the air]
42
43Source: USGS real-time feeds · rerun: `[exact curl]`
44*Informational — for safety decisions follow official emergency guidance, not this summary.*
45
46## Quality Checks
47
48- [ ] The direct yes/no answer leads before any table
49- [ ] Depth appears next to magnitude on every quoted event
50- [ ] Times are converted to the user's local zone with the relative offset
51- [ ] Regional questions used radius filtering, not eyeballed global feeds
52- [ ] Safety-shaped questions route to official sources by name
53
54## Anti-Patterns
55
56- [ ] Do not answer from memory — seismicity is the definition of live data; fetch or hand over the command
57- [ ] Do not quote magnitude without depth — half the felt-intensity story
58- [ ] Do not predict aftershocks or all-clears — that's official-agency territory, linked not imitated
59- [ ] Do not present the global significant feed as "nothing near you" — filter by place before saying no
60- [ ] Do not dramatize small events or shrug at large ones — the bands calibrate the tone
gabrielmoreira