# Travel Guide

> Travel Guide is an Agent Skill for documents published in the microsoft-foundry/foundry-samples repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Creates colorful PDF travel guides for cities, including itinerary ideas, neighborhoods, food, practical tips, and photo-worthy stops. Use when the user asks for a travel guide, city guide, itinerary, trip plan, or PDF document for a destination.

- Skill name: `travel-guide`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/microsoft-foundry/foundry-samples/blob/HEAD/samples/python/hosted-agents/agent-framework/responses/07-skills/src/agent-framework-agent-with-skills-responses/skills/travel-guide/SKILL.md
- Repository: microsoft-foundry/foundry-samples (388 GitHub stars when collected)

## SKILL.md

# Travel guide skill

Use this skill when the user wants a city travel guide, itinerary, or downloadable PDF trip-planning document.

## Workflow

1. Identify the city or destination from the user's request.
2. Infer the trip length and interests when provided. If the user does not specify them, use a 3-day guide and a balanced mix of culture, food, neighborhoods, views, and practical tips.
3. Run the PDF generator script:
   - skill name: `travel-guide`
   - script name: `scripts/create_travel_guide.py`
   - args: a JSON array of string CLI flags and values. Supported flags:
     - `--city <city>`: destination city, required
     - `--days <number>`: number of itinerary days, optional, defaults to `3`
     - `--interests <list>`: comma-separated interests such as `food,art,history,views`, optional
     - `--tone <style>`: guide style such as `family-friendly`, `luxury`, `budget`, or `first-time visitor`, optional
4. After the script returns, tell the user the `$HOME`-based PDF path and briefly summarize the guide.

## Available scripts

- `scripts/create_travel_guide.py` - Generates a colorful PDF travel guide and returns JSON with the saved file path.

## Example script arguments

```json
["--city", "Lisbon", "--days", "3", "--interests", "food,viewpoints,neighborhoods", "--tone", "first-time visitor"]
```

---

Source: https://www.openparable.com/skill/documents/travel-guide (OpenParable). Cite the canonical URL above.