# Send Test Gas Skill 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "test-gas-skill",
    "name": "Test Gas Skill",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "canonicalUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/test-gas-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=test-gas-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/locations.md",
      "references/zip_codes.md",
      "scripts/gas_alternative.py",
      "scripts/gasbuddy_search.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "test-gas-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T08:01:42.817Z",
      "expiresAt": "2026-05-07T08:01:42.817Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=test-gas-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=test-gas-skill",
        "contentDisposition": "attachment; filename=\"test-gas-skill-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "test-gas-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/test-gas-skill"
    },
    "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/test-gas-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/test-gas-skill",
    "agentUrl": "https://openagent3.xyz/skills/test-gas-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/test-gas-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/test-gas-skill/agent.md"
  }
}
```
## Documentation

### Overview

Automatically search for the cheapest gas prices in your area, with a focus on Costco and other discount stations. Get daily notifications with the best options within a specified radius.

### Quick Start

Configure location - Set your city/coordinates and search radius
Run search - Find gas stations and estimated prices
Schedule daily alerts - Get morning notifications with cheapest options
Focus on Costco - Costco typically has gas $0.15-0.25 below market average

### Step 1: Configure Your Location

Option A: Use ZIP code (recommended)

# Search by ZIP code
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary

Option B: Use coordinates

Default locations are pre-configured for Columbus, Ohio:

# Columbus, OH (downtown)
lat: 39.9612
lon: -82.9988
radius: 20 miles

To use a different location:

python3 scripts/gas_alternative.py --lat <latitude> --lon <longitude> --radius <miles>

Common US cities:

Columbus, OH: 39.9612, -82.9988
Chicago, IL: 41.8781, -87.6298
New York, NY: 40.7128, -74.0060
Los Angeles, CA: 34.0522, -118.2437
Miami, FL: 25.7617, -80.1918

### Step 2: Search for Gas Stations

# Search with summary output
python3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --summary

# Save to file
python3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --output gas_prices.json

Parameters:

--zip: ZIP code (overrides lat/lon, e.g., --zip 43215)
--lat: Latitude (default: 39.9612 - Columbus, OH)
--lon: Longitude (default: -82.9988 - Columbus, OH)
--radius: Search radius in miles (default: 20)
--fuel: Fuel type - 87, 89, 91, diesel (default: 87)
--base-price: Base price for estimation (default: 2.89)
--output: Output file (default: gas_prices.json)
--summary: Print human-readable summary to stdout

### Step 3: Set Up Daily Alerts

Use OpenClaw cron to receive daily morning notifications:

{
  "name": "Gas price alert",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "America/New_York"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "Get me gas prices for Columbus, OH this morning. Focus on Costco and show the cheapest 87 octane within 20 miles of downtown."
  },
  "sessionTarget": "main"
}

This runs every day at 8 AM Eastern Time.

### Step 4: Receive Notifications

The agent will:

Search for gas stations in your area
Identify Costco and discount stations
Generate a summary with the cheapest options
Send the summary via Telegram

Example notification:

⛽ Gas Prices (87 Octane) - Columbus, OH

🏠 Costco (Typically Cheapest)
• Costco Gas
  💰 $2.69 (est.)
  📍 5000 Morse Rd, Columbus, OH 43213 (7.9 miles from downtown)

💡 Tip: Costco typically has gas $0.15-0.25 below market average.

### Output Format

Each station includes:

{
  "source": "osm",
  "name": "Costco Gas",
  "brand": "Costco",
  "address": "5000 Morse Rd, Columbus, OH 43213",
  "lat": 39.9667,
  "lon": -82.8500,
  "distance": 7.9,
  "fuel_type": "87",
  "price": 2.69,
  "price_text": "$2.69 (est.)",
  "is_costco": true,
  "scraped_at": "2026-02-10T21:00:00.000Z"
}

### How It Works

OpenStreetMap/Overpass API - Finds all gas stations in the area
Costco database - Known Costco locations are matched and prioritized
Price estimation - Costco prices estimated $0.15-0.25 below market average
Distance calculation - Uses geodesic distance for accurate mileage
Smart filtering - Removes duplicates and sorts by relevance

### Limitations

Real-time prices: Currently uses estimated prices for Costco. For exact prices, check GasBuddy.com or station apps.
Coverage: Relies on OpenStreetMap data completeness
Estimation accuracy: Costco prices estimated based on typical discount patterns

### For Real-Time Prices

To get actual real-time prices:

GasBuddy.com - Check manually or use their commercial API
Station apps - Costco, Kroger, Shell, etc., have apps with current prices
AAA - Provides average prices by region
Waze - Community-sourced price updates

### No stations found

Increase the --radius parameter
Verify coordinates are correct
Check if the area has good OpenStreetMap coverage

### Incorrect prices

Prices for non-Costco stations are estimated as "N/A"
Costco prices are estimates based on typical discount patterns
For exact prices, use GasBuddy or the station's app

### Geopy not installed

pip install geopy

### scripts/gas_alternative.py

Main script for searching gas stations using OpenStreetMap and Overpass API.

Features:

Finds all gas stations within radius
Identifies Costco locations
Estimates Costco prices
Calculates distances
Generates human-readable summaries

### scripts/gasbuddy_search.py

Alternative script for GasBuddy integration (requires Playwright or API key).

Use when:

You have a GasBuddy API key
You need real-time prices
You're willing to use Playwright for JavaScript rendering

### references/locations.md

Coordinates and configurations for common US cities.

### Dependencies

Install required packages:

pip install requests geopy

For Playwright-based GasBuddy scraping (optional):

pip install playwright
playwright install
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: GustavoZiaugra
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T08:01:42.817Z
- Expires at: 2026-05-07T08:01:42.817Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/test-gas-skill)
- [Send to Agent page](https://openagent3.xyz/skills/test-gas-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/test-gas-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/test-gas-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/test-gas-skill)