agentleFS
tsukhanitsukhani/jclaw/skills/restaurant-recommender/SKILL.md

restaurant-recommender

Skill42 starsChanged 8 days agoMITView on GitHub

Search the web for highest-rated restaurants in a specified city and provide findings directly in chat with names, ratings, reviews, and contact information.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When asked to find top-rated restaurants:

    line 13
  2. Very specific:

    Use the web_search tool to find highly-rated restaurants in the specified city.

    line 26
  3. Distinctive:

    Search queries should target Google Reviews, Yelp, TripAdvisor, and local food blogs

    line 27
  4. Very specific:

    Use web_fetch with format="text" to extract readable content from review sites

    line 34
  5. Distinctive:

    Add a "Methodology" section explaining data sources

    line 75
  6. Distinctive:

    No city provided: Ask the user which city to search

    line 79
  7. Distinctive:

    When asked "What are the best restaurants in Bangkok?", respond in chat:

    line 87

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Restaurant Recommender

When asked to find top-rated restaurants:

1. Identify the Target City

Check if a city was specified in the user's request.

  • If a city is provided (e.g., "find restaurants in Penang", "best food in Singapore"): Use that city
  • If no city is specified (e.g., "recommend some restaurants", "find good places to eat"): Ask the user for their city before proceeding

Example prompt: "I'd be happy to recommend some restaurants! What city would you like me to search in?"

2. Search for Restaurant Data

Use the web_search tool to find highly-rated restaurants in the specified city.

  • Search queries should target Google Reviews, Yelp, TripAdvisor, and local food blogs
  • Include keywords like "best restaurants [CITY]", "top rated restaurants [CITY]", "highest rated restaurants [CITY] 2024", "best restaurants [CITY] Google Reviews"
  • Retrieve at least 10 results to ensure comprehensive coverage

3. Fetch Detailed Information

For each promising restaurant found:

  • Use web_fetch with format="text" to extract readable content from review sites
  • Prioritize Google Maps results, official websites, and reliable review platforms
  • Extract: restaurant name, rating (out of 5), number of reviews, address, phone number, cuisine type, price range, and notable review excerpts

4. Compile Chat Response

Present the findings directly in chat response with the following structure:

# Top-Rated Restaurants in [CITY]

*Report generated: [DATE]*

## Summary
Found [N] restaurants with ratings of X.X+ stars, averaging X.X stars across [N] total reviews.

---

## Restaurant Name 1
- **Rating:** X.X/5 ⭐ ([N] reviews)
- **Cuisine:** [Type]
- **Price Range:** $/$$/$$$/$$$$ (or local currency range)
- **Address:** [Full Address]
- **Phone:** [Contact Number]
- **Review Highlight:** *"[Notable review excerpt]"*

---

## Restaurant Name 2
...

---

## Methodology
Data compiled from Google Reviews, TripAdvisor, Yelp, and local food publications. Last updated: [DATE].

Response Requirements:

  • Include at least 8-10 top-rated restaurants from the specified city
  • Sort by rating (highest first), then by number of reviews
  • Include a brief summary at the top with key statistics
  • Add a "Methodology" section explaining data sources

5. Edge Cases & Error Handling

  • No city provided: Ask the user which city to search
  • City specified but no results found: Inform the user and suggest alternative search terms, nearby areas, or ask if they'd like to try a different city
  • Incomplete data: Note "information not available" for missing fields
  • Conflicting ratings: Cross-reference multiple sources and note discrepancies
  • Outdated info: Aim for reviews from the last 12 months; note if older data is used

Example Output

When asked "What are the best restaurants in Bangkok?", respond in chat:

# Top-Rated Restaurants in Bangkok

*Report generated: April 8, 2026*

## Summary
Found 10 restaurants with ratings of 4.5+ stars, averaging 4.7 stars across [N] total reviews.

---

## 1. [PERSONAL_NAME]
- **Rating:** 4.8/5 ⭐ (1,245 reviews)
- **Cuisine:** Indian / Fine Dining
- **Price Range:** $$$$
- **Address:** [ADDRESS]
- **Phone:** [PHONE_NUMBER]
- **Review Highlight:** *"Progressive Indian cuisine with playful presentations and bold flavors..."*

...

---

## Methodology
Data compiled from Google Reviews, TripAdvisor, Yelp, and local food publications. Last updated: April 2026.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.