Agent skill · writing content · nousresearch
maps
Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.
Why this skill is useful
Adds 8 executable commands for geocoding, routing, and POI searching using OpenStreetMap data that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Maps Skill Location intelligence using free, open data sources. 8 commands, 44 POI categories, zero dependencies (Python stdlib only), no API key required. Data sources: OpenStreetMap/Nominatim, Overpass API, OSRM, TimeAPI.io. This skill supersedes the old find-nearby skill — all of find-nearby's functionality is covered by the nearby command below, with the same --near "<place>" shortcut and multi-category support. When to Use User sends a Telegram location pin (latitude/longitude in the message) → nearby User wants coordinates for a place name → search User has coordinates and wants the address → reverse User asks for nearby restaurants, hospitals, pharmacies, hotels, etc. → nearby User wants driving/walking/cycling distance or travel time → distance User wants turn-by-turn directions between two places → directions User wants timezone information for a location → timezone User wants to search for POIs within a geographic area → area + bbox Prerequisites Python 3.8+ (stdlib only — no pip installs needed). Script path: ~/.hermes/skills/maps/scripts/mapsclient.py Commands search — Geocode a place name Returns: lat, lon, display name, type, bounding box, importance score. reverse — Coordinates to address Returns: full address breakdown (street, city, state, country, postcode). nearby — Find places by category 46 categories: restaurant, cafe, bar, hospital, pharmacy, hotel, guesthouse, campsite, supermarket, atm, gasstation, parking, museum, park, school, university, bank, police, firestation, library, airport, trainstation, busstop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym, swimmingpool, postoffice, conveniencestore, bakery, bookshop, laundry, carwash, carrental, bicyclerental, taxi, veterinary, zoo, playground, stadium, nightclub. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/maps