# Send Commute Traffic to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-commute-traffic",
    "name": "Commute Traffic",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/Xavjer/openclaw-commute-traffic",
    "canonicalUrl": "https://clawhub.ai/Xavjer/openclaw-commute-traffic",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-commute-traffic",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-commute-traffic",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "INSTALL.md",
      "SKILL.md",
      "references/tomtom-api-response.md",
      "scripts/check_traffic.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-commute-traffic"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-commute-traffic",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-commute-traffic",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-commute-traffic/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-commute-traffic/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-commute-traffic/agent.md"
  }
}
```
## Documentation

### Purpose

Query real-time traffic data from TomTom for any route and provide the user with actionable travel advice. The script handles geocoding (resolving place names to coordinates) and routing (calculating travel time with live traffic) — all via the same TomTom API key.

### Determining Origin and Destination

The origin and destination are not static — you must determine them from what the user tells you. Examples:

"How's traffic from the office to home?" → You must know (or ask) where their office and home are.
"Check traffic Basel to Zurich" → origin=Basel, destination=Zurich.
"Should I leave now?" → Use previously discussed or known origin/destination. If unknown, ask.
"What's the commute like?" → If you know the user's regular commute, use that. Otherwise, ask.

Rules:

If both origin and destination are clear from context, proceed immediately.
If only one is clear, ask for the missing one.
If neither is clear and you have no prior context, ask the user for both.
Accept any format: addresses, city names, landmarks, coordinates — the script geocodes automatically.

### Running the Traffic Check

Execute the script with origin and destination as arguments:

python3 {baseDir}/scripts/check_traffic.py --origin "<ORIGIN>" --destination "<DESTINATION>"

Examples:

python3 {baseDir}/scripts/check_traffic.py --origin "Basel, Switzerland" --destination "Zurich, Switzerland"
python3 {baseDir}/scripts/check_traffic.py --origin "Basel SBB" --destination "Paradeplatz, Zürich"
python3 {baseDir}/scripts/check_traffic.py --origin "Aeschenplatz, Basel" --destination "ETH Zürich"

### Interpreting the Output

The script returns JSON with one or more route alternatives. For each route:

FieldMeaningtravel_time_minTotal travel time with current live trafficno_traffic_time_minTravel time with zero traffic (free-flow)historic_traffic_time_minTypical travel time based on historical patternslive_traffic_time_minTime including live incident datatraffic_delay_minExtra delay caused by current traffictraffic_delay_pctDelay as percentage of free-flow timecongestionDerived level: light, moderate, or heavydistance_kmRoute distance in kilometersdeparture_time / arrival_timeDeparture and estimated arrival timestamps

### Congestion classification:

Light: traffic delay adds less than 20% to free-flow time
Moderate: 20–50% above free-flow
Heavy: more than 50% above free-flow

### Presenting Results to the User

When presenting traffic data, always include:

The fastest route and its estimated travel time.
Traffic delay in plain language (e.g., "Currently 8 minutes delay due to traffic on the A2, adding about 15% to the normal drive time").
Comparison of alternatives if multiple routes are returned.
A recommendation: whether to leave now or wait, based on congestion level.

Keep it concise and practical. The user wants to know: "How long will it take and should I go now?"

### Error Handling

If the script returns {"status": "error"}, relay the error message to the user.
If TOMTOM_API_KEY is not configured, tell the user to set it up in ~/.openclaw/openclaw.json.
If geocoding fails (no coordinates found), the location may be too vague — ask the user to be more specific.
If no routes are returned, suggest trying different location descriptions.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Xavjer
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-commute-traffic)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-commute-traffic/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-commute-traffic/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-commute-traffic/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-commute-traffic)