[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ED9X0QQSCY6FNFES5PPT3C":3,"skill-same:01M7ED9X0QQSCY6FNFES5PPT3C":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ED9X0QQSCY6FNFES5PPT3C","maps",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fmaps\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# maps\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\npython $MAPS search \"Eiffel Tower\"\npython $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\npython $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)\npython $MAPS nearby 48.8584 2.2945 restaurant --limit 10\npython $MAPS nearby 40.7128 -74.0060 hospital --radius 2000\n\n# By address \u002F city \u002F zip \u002F landmark — --near auto-geocodes\npython $MAPS nearby --near \"Times Square, New York\" --category cafe\npython $MAPS nearby --near \"90210\" --category pharmacy\n\n# Multiple categories merged into one query\npython $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\npython $MAPS distance \"Paris\" --to \"Lyon\"\npython $MAPS distance \"New York\" --to \"Boston\" --mode driving\npython $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\npython $MAPS directions \"Eiffel Tower\" --to \"Louvre Museum\" --mode walking\npython $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\npython $MAPS timezone 48.8584 2.2945\npython $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\npython $MAPS area \"Manhattan, New York\"\npython $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\npython $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\"\npython $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\npython ~\u002F.hermes\u002Fskills\u002Fmaps\u002Fscripts\u002Fmaps_client.py search \"Statue of Liberty\"\n# Should return lat ~40.689, lon ~-74.044\n\npython ~\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",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fproductivity\u002Fmaps","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill maps",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill maps",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill maps","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fmaps\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",311,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fmaps\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]