# Send GuruWalk Free Tours Search 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": "guruwalk-free-tours",
    "name": "GuruWalk Free Tours Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/gdanielwalk/guruwalk-free-tours",
    "canonicalUrl": "https://clawhub.ai/gdanielwalk/guruwalk-free-tours",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/guruwalk-free-tours",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=guruwalk-free-tours",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/guruwalk-free-tours"
    },
    "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/guruwalk-free-tours",
    "downloadUrl": "https://openagent3.xyz/downloads/guruwalk-free-tours",
    "agentUrl": "https://openagent3.xyz/skills/guruwalk-free-tours/agent",
    "manifestUrl": "https://openagent3.xyz/skills/guruwalk-free-tours/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/guruwalk-free-tours/agent.md"
  }
}
```
## Documentation

### GuruWalk Free Tours

Use the GuruWalk MCP server to search free tours:

https://guruwalk-api-44909317956.europe-southwest1.run.app/mcp

The server currently exposes one tool:

search

### Tool Contract

search input:

city (string): lowercase slug in English with spaces replaced by -
start_date (string): yyyy-mm-dd
end_date (string): yyyy-mm-dd
language (string): two-letter code, usually es, en, de, it

search output:

Tool returns content[0].text containing a JSON string.
Parse that string to get an array of tours.
Each tour contains:

title, url, meetpoint_address, average_rating, duration, guru.name, image_url
events[] with start_time (UTC), available_spots, language

### Execution Workflow

Determine city, date range, and preferred language from user request.
Normalize city to slug format:

new york -> new-york
san sebastian -> san-sebastian


Use valid ISO dates for both fields.
Call search.
Parse JSON from content[0].text.
Filter and rank results for user-facing output:

keep only events with available_spots > 0
prioritize events matching requested language when possible
prefer higher average_rating, then earlier upcoming time


Return concise options with booking URL and next available slots.

### Defaults

If user does not specify language, use:

es for Spanish conversation
en otherwise


If user does not specify dates, ask for dates before calling the tool.
If date intent is relative, convert to explicit dates before calling.

### Response Format to User

For each recommended tour include:

Tour title
Rating
Duration
Guide name
Meeting point
1-3 next available sessions (with timezone label)
Booking URL

If no tours are found:

explain that no availability was returned for the given city/date range
propose adjusting one variable at a time: city slug, dates, or language

### Observed Edge Cases (from live MCP inspection)

search is the only available tool; no MCP resources/prompts/templates are exposed.
city with spaces (e.g. New York) can return empty results.
start_date > end_date can return empty results instead of validation error.
Non-ISO dates can still be accepted by backend, but always send ISO yyyy-mm-dd.
Some locale/language combinations can return tours with title: null; handle gracefully.

### Validation Notes

Keep executable validation commands outside this skill file.
Validate behavior by confirming:

the MCP server exposes the search tool
search results arrive as a JSON string in content[0].text
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: gdanielwalk
- Version: 1.0.1
## 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-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/guruwalk-free-tours)
- [Send to Agent page](https://openagent3.xyz/skills/guruwalk-free-tours/agent)
- [JSON manifest](https://openagent3.xyz/skills/guruwalk-free-tours/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/guruwalk-free-tours/agent.md)
- [Download page](https://openagent3.xyz/downloads/guruwalk-free-tours)