[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B178K1ET2DPNY6WMC0AD6J":3,"skill-same:01M7B178K1ET2DPNY6WMC0AD6J":76},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":14,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":6,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M7B178K1ET2DPNY6WMC0AD6J","maps",null,"Geocode, POIs, routes, timezones via OpenStreetMap\u002FOSRM.","dbillion\u002Fhermes-skills-public","dbillion","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49393855?v=4","01M7AVH8QPGCM8WKWS22TRT0T6","Oludayo Adeoye","01M7AVH8RD1JJWA0YS9CFEWAV9",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fmaps\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: maps\ndescription: \"Geocode, POIs, routes, timezones via OpenStreetMap\u002FOSRM.\"\nversion: 1.2.0\nauthor: Mibayy\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [maps, geocoding, places, routing, distance, directions, nearby, location, openstreetmap, nominatim, overpass, osrm]\n    category: productivity\n    requires_toolsets: [terminal]\n    supersedes: [find-nearby]\n---\n\n# Maps Skill\n\nLocation intelligence using free, open data sources. 8 commands, 44 POI\ncategories, zero dependencies (Python stdlib only), no API key required.\n\nData sources: OpenStreetMap\u002FNominatim, Overpass API, OSRM, TimeAPI.io.\n\nThis skill supersedes the old `find-nearby` skill — all of find-nearby's\nfunctionality is covered by the `nearby` command below, with the same\n`--near \"\u003Cplace>\"` shortcut and multi-category support.\n\n## When to Use\n\n- User sends a Telegram location pin (latitude\u002Flongitude in the message) → `nearby`\n- User wants coordinates for a place name → `search`\n- User has coordinates and wants the address → `reverse`\n- User asks for nearby restaurants, hospitals, pharmacies, hotels, etc. → `nearby`\n- User wants driving\u002Fwalking\u002Fcycling distance or travel time → `distance`\n- User wants turn-by-turn directions between two places → `directions`\n- User wants timezone information for a location → `timezone`\n- User wants to search for POIs within a geographic area → `area` + `bbox`\n\n## Prerequisites\n\nPython 3.8+ (stdlib only — no pip installs needed).\n\nScript path: `~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py`\n\n## Commands\n\n```bash\nMAPS=~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py\n```\n\n### search — Geocode a place name\n\n```bash\npython3 $MAPS search \"Eiffel Tower\"\npython3 $MAPS search \"1600 Pennsylvania Ave, Washington DC\"\n```\n\nReturns: lat, lon, display name, type, bounding box, importance score.\n\n### reverse — Coordinates to address\n\n```bash\npython3 $MAPS reverse 48.8584 2.2945\n```\n\nReturns: full address breakdown (street, city, state, country, postcode).\n\n### nearby — Find places by category\n\n```bash\n# By coordinates (from a Telegram location pin, for example)\npython3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10\npython3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000\n\n# By address \u002F city \u002F zip \u002F landmark — --near auto-geocodes\npython3 $MAPS nearby --near \"Times Square, New York\" --category cafe\npython3 $MAPS nearby --near \"90210\" --category pharmacy\n\n# Multiple categories merged into one query\npython3 $MAPS nearby --near \"downtown austin\" --category restaurant --category bar --limit 10\n```\n\n46 categories: restaurant, cafe, bar, hospital, pharmacy, hotel, guest_house,\ncamp_site, supermarket, atm, gas_station, parking, museum, park, school,\nuniversity, bank, police, fire_station, library, airport, train_station,\nbus_stop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym,\nswimming_pool, post_office, convenience_store, bakery, bookshop, laundry,\ncar_wash, car_rental, bicycle_rental, taxi, veterinary, zoo, playground,\nstadium, nightclub.\n\nEach result includes: `name`, `address`, `lat`\u002F`lon`, `distance_m`,\n`maps_url` (clickable Google Maps link), `directions_url` (Google Maps\ndirections from the search point), and promoted tags when available —\n`cuisine`, `hours` (opening_hours), `phone`, `website`.\n\n### distance — Travel distance and time\n\n```bash\npython3 $MAPS distance \"Paris\" --to \"Lyon\"\npython3 $MAPS distance \"New York\" --to \"Boston\" --mode driving\npython3 $MAPS distance \"Big Ben\" --to \"Tower Bridge\" --mode walking\n```\n\nModes: driving (default), walking, cycling. Returns road distance, duration,\nand straight-line distance for comparison.\n\n### directions — Turn-by-turn navigation\n\n```bash\npython3 $MAPS directions \"Eiffel Tower\" --to \"Louvre Museum\" --mode walking\npython3 $MAPS directions \"JFK Airport\" --to \"Times Square\" --mode driving\n```\n\nReturns numbered steps with instruction, distance, duration, road name, and\nmaneuver type (turn, depart, arrive, etc.).\n\n### timezone — Timezone for coordinates\n\n```bash\npython3 $MAPS timezone 48.8584 2.2945\npython3 $MAPS timezone 35.6762 139.6503\n```\n\nReturns timezone name, UTC offset, and current local time.\n\n### area — Bounding box and area for a place\n\n```bash\npython3 $MAPS area \"Manhattan, New York\"\npython3 $MAPS area \"London\"\n```\n\nReturns bounding box coordinates, width\u002Fheight in km, and approximate area.\nUseful as input for the bbox command.\n\n### bbox — Search within a bounding box\n\n```bash\npython3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20\n```\n\nFinds POIs within a geographic rectangle. Use `area` first to get the\nbounding box coordinates for a named place.\n\n## Working With Telegram Location Pins\n\nWhen a user sends a location pin, the message contains `latitude:` and\n`longitude:` fields. Extract those and pass them straight to `nearby`:\n\n```bash\n# User sent a pin at 36.17, -115.14 and asked \"find cafes nearby\"\npython3 $MAPS nearby 36.17 -115.14 cafe --radius 1500\n```\n\nPresent results as a numbered list with names, distances, and the\n`maps_url` field so the user gets a tap-to-open link in chat. For \"open\nnow?\" questions, check the `hours` field; if missing or unclear, verify\nwith `web_search` since OSM hours are community-maintained and not always\ncurrent.\n\n## Workflow Examples\n\n**\"Find Italian restaurants near the Colosseum\":**\n1. `nearby --near \"Colosseum Rome\" --category restaurant --radius 500`\n   — one command, auto-geocoded\n\n**\"What's near this location pin they sent?\":**\n1. Extract lat\u002Flon from the Telegram message\n2. `nearby LAT LON cafe --radius 1500`\n\n**\"How do I walk from hotel to conference center?\":**\n1. `directions \"Hotel Name\" --to \"Conference Center\" --mode walking`\n\n**\"What restaurants are in downtown Seattle?\":**\n1. `area \"Downtown Seattle\"` → get bounding box\n2. `bbox S W N E restaurant --limit 30`\n\n## Pitfalls\n\n- Nominatim ToS: max 1 req\u002Fs (handled automatically by the script)\n- `nearby` requires lat\u002Flon OR `--near \"\u003Caddress>\"` — one of the two is needed\n- OSRM routing coverage is best for Europe and North America\n- Overpass API can be slow during peak hours; the script automatically\n  falls back between mirrors (overpass-api.de → overpass.kumi.systems)\n- `distance` and `directions` use `--to` flag for the destination (not positional)\n- If a zip code alone gives ambiguous results globally, include country\u002Fstate\n\n## Verification\n\n```bash\npython3 ~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py search \"Statue of Liberty\"\n# Should return lat ~40.689, lon ~-74.044\n\npython3 ~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py nearby --near \"Times Square\" --category restaurant --limit 3\n# Should return a list of restaurants within ~500m of Times Square\n```\n","# Maps Skill\n\nLocation intelligence using free, open data sources. 8 commands, 44 POI\ncategories, zero dependencies (Python stdlib only), no API key required.\n\nData sources: OpenStreetMap\u002FNominatim, Overpass API, OSRM, TimeAPI.io.\n\nThis skill supersedes the old `find-nearby` skill — all of find-nearby's\nfunctionality is covered by the `nearby` command below, with the same\n`--near \"\u003Cplace>\"` shortcut and multi-category support.\n\n## When to Use\n\n- User sends a Telegram location pin (latitude\u002Flongitude in the message) → `nearby`\n- User wants coordinates for a place name → `search`\n- User has coordinates and wants the address → `reverse`\n- User asks for nearby restaurants, hospitals, pharmacies, hotels, etc. → `nearby`\n- User wants driving\u002Fwalking\u002Fcycling distance or travel time → `distance`\n- User wants turn-by-turn directions between two places → `directions`\n- User wants timezone information for a location → `timezone`\n- User wants to search for POIs within a geographic area → `area` + `bbox`\n\n## Prerequisites\n\nPython 3.8+ (stdlib only — no pip installs needed).\n\nScript path: `~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py`\n\n## Commands\n\n```bash\nMAPS=~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py\n```\n\n### search — Geocode a place name\n\n```bash\npython3 $MAPS search \"Eiffel Tower\"\npython3 $MAPS search \"1600 Pennsylvania Ave, Washington DC\"\n```\n\nReturns: lat, lon, display name, type, bounding box, importance score.\n\n### reverse — Coordinates to address\n\n```bash\npython3 $MAPS reverse 48.8584 2.2945\n```\n\nReturns: full address breakdown (street, city, state, country, postcode).\n\n### nearby — Find places by category\n\n```bash\n# By coordinates (from a Telegram location pin, for example)\npython3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10\npython3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000\n\n# By address \u002F city \u002F zip \u002F landmark — --near auto-geocodes\npython3 $MAPS nearby --near \"Times Square, New York\" --category cafe\npython3 $MAPS nearby --near \"90210\" --category pharmacy\n\n# Multiple categories merged into one query\npython3 $MAPS nearby --near \"downtown austin\" --category restaurant --category bar --limit 10\n```\n\n46 categories: restaurant, cafe, bar, hospital, pharmacy, hotel, guest_house,\ncamp_site, supermarket, atm, gas_station, parking, museum, park, school,\nuniversity, bank, police, fire_station, library, airport, train_station,\nbus_stop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym,\nswimming_pool, post_office, convenience_store, bakery, bookshop, laundry,\ncar_wash, car_rental, bicycle_rental, taxi, veterinary, zoo, playground,\nstadium, nightclub.\n\nEach result includes: `name`, `address`, `lat`\u002F`lon`, `distance_m`,\n`maps_url` (clickable Google Maps link), `directions_url` (Google Maps\ndirections from the search point), and promoted tags when available —\n`cuisine`, `hours` (opening_hours), `phone`, `website`.\n\n### distance — Travel distance and time\n\n```bash\npython3 $MAPS distance \"Paris\" --to \"Lyon\"\npython3 $MAPS distance \"New York\" --to \"Boston\" --mode driving\npython3 $MAPS distance \"Big Ben\" --to \"Tower Bridge\" --mode walking\n```\n\nModes: driving (default), walking, cycling. Returns road distance, duration,\nand straight-line distance for comparison.\n\n### directions — Turn-by-turn navigation\n\n```bash\npython3 $MAPS directions \"Eiffel Tower\" --to \"Louvre Museum\" --mode walking\npython3 $MAPS directions \"JFK Airport\" --to \"Times Square\" --mode driving\n```\n\nReturns numbered steps with instruction, distance, duration, road name, and\nmaneuver type (turn, depart, arrive, etc.).\n\n### timezone — Timezone for coordinates\n\n```bash\npython3 $MAPS timezone 48.8584 2.2945\npython3 $MAPS timezone 35.6762 139.6503\n```\n\nReturns timezone name, UTC offset, and current local time.\n\n### area — Bounding box and area for a place\n\n```bash\npython3 $MAPS area \"Manhattan, New York\"\npython3 $MAPS area \"London\"\n```\n\nReturns bounding box coordinates, width\u002Fheight in km, and approximate area.\nUseful as input for the bbox command.\n\n### bbox — Search within a bounding box\n\n```bash\npython3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20\n```\n\nFinds POIs within a geographic rectangle. Use `area` first to get the\nbounding box coordinates for a named place.\n\n## Working With Telegram Location Pins\n\nWhen a user sends a location pin, the message contains `latitude:` and\n`longitude:` fields. Extract those and pass them straight to `nearby`:\n\n```bash\n# User sent a pin at 36.17, -115.14 and asked \"find cafes nearby\"\npython3 $MAPS nearby 36.17 -115.14 cafe --radius 1500\n```\n\nPresent results as a numbered list with names, distances, and the\n`maps_url` field so the user gets a tap-to-open link in chat. For \"open\nnow?\" questions, check the `hours` field; if missing or unclear, verify\nwith `web_search` since OSM hours are community-maintained and not always\ncurrent.\n\n## Workflow Examples\n\n**\"Find Italian restaurants near the Colosseum\":**\n1. `nearby --near \"Colosseum Rome\" --category restaurant --radius 500`\n   — one command, auto-geocoded\n\n**\"What's near this location pin they sent?\":**\n1. Extract lat\u002Flon from the Telegram message\n2. `nearby LAT LON cafe --radius 1500`\n\n**\"How do I walk from hotel to conference center?\":**\n1. `directions \"Hotel Name\" --to \"Conference Center\" --mode walking`\n\n**\"What restaurants are in downtown Seattle?\":**\n1. `area \"Downtown Seattle\"` → get bounding box\n2. `bbox S W N E restaurant --limit 30`\n\n## Pitfalls\n\n- Nominatim ToS: max 1 req\u002Fs (handled automatically by the script)\n- `nearby` requires lat\u002Flon OR `--near \"\u003Caddress>\"` — one of the two is needed\n- OSRM routing coverage is best for Europe and North America\n- Overpass API can be slow during peak hours; the script automatically\n  falls back between mirrors (overpass-api.de → overpass.kumi.systems)\n- `distance` and `directions` use `--to` flag for the destination (not positional)\n- If a zip code alone gives ambiguous results globally, include country\u002Fstate\n\n## Verification\n\n```bash\npython3 ~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py search \"Statue of Liberty\"\n# Should return lat ~40.689, lon ~-74.044\n\npython3 ~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py nearby --near \"Times Square\" --category restaurant --limit 3\n# Should return a list of restaurants within ~500m of Times Square\n```\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":45,"description":7},"Mibayy","1.2.0",{"hermes":27},{"tags":28,"category":40,"supersedes":41,"requires_toolsets":43},[5,29,30,31,32,33,34,35,36,37,38,39],"geocoding","places","routing","distance","directions","nearby","location","openstreetmap","nominatim","overpass","osrm","productivity",[42],"find-nearby",[44],"terminal",[46,47,48],"linux","macos","windows","master","f341c46fed021656175d5c9ccc67a72126e50bfb","skills\u002Fproductivity\u002Fmaps","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public","https:\u002F\u002Fgithub.com\u002Fdbillion","I enjoy writing codes,teaching programming, solving problems, tasted automation in Python and never looked back😋😋😋💞","2026-10-14 03:31:55",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add dbillion\u002Fhermes-skills-public --skill maps",{"tool":62,"command":63},"bunx","bunx skills add dbillion\u002Fhermes-skills-public --skill maps",{"tool":65,"command":66},"pnpm","pnpm dlx skills add dbillion\u002Fhermes-skills-public --skill maps","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fmaps\u002FSKILL.md",true,[70],{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"scripts\u002Fmaps_client.py","SCRIPT","脚本",46678,"https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fmaps\u002Fscripts\u002Fmaps_client.py",[77,84,91,100,107,114],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7B25T0V7RBKES86Y3RTXQRN","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7B25DSBBMZRHVD28MAX7N5X","gemini-vision-fallback","Vision fallback: Gemini REST API if vision_analyze blocked.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fvision\u002Fgemini-vision-fallback\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":95,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7B22XW9QXT2ZWWXVZDFWYZP","twitter-cli","Use twitter-cli for ALL Twitter\u002FX operations — reading tweets, posting, replying, quoting, liking, retweeting, following, searching, user lookups. Invoke whenever user requests any Twitter interaction.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ftwitter-cli\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ftwitter-cli\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7B22QMWY1B4F7BC114RG4S6","prism-scan","Structural analysis through dynamically generated cognitive lenses. Generates the optimal analytical lens for the specific code\u002Fartifact, then executes it. Finds conservation laws, structural invariants, and concrete bugs that vanilla analysis misses. Use on any code file, system design, or text artifact.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-scan\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M7B22JA5XCAP1ACT6V50WYR1","prism-reflect","Constraint transparency: analyzes an artifact structurally, then analyzes what its own analysis concealed. Produces a conservation law AND a constraint report showing what was maximized, what was sacrificed, and what to investigate next. The only AI skill that knows what it can't see.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-reflect\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":19},"01M7B22EB15M75M4X3C52YGDCC","prism-full","Full Prism: multi-pass structural analysis with mandatory adversarial self-correction. Designs custom analytical passes, executes them with chaining, then attacks its own findings before synthesizing. Use for maximum depth on important code or artifacts.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-full\u002FSKILL.md",[],[]]