Agent skill

Atlas Obscura

by borski in borski/travel-hacking-toolkit

Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination.

MITAuto-check passed

Install Atlas Obscura

skills CLI
$ npx skills add borski/travel-hacking-toolkit --skill atlas-obscura -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borski/travel-hacking-toolkit atlas-obscura --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borski/travel-hacking-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/travel-hacking-toolkit/skills/atlas-obscura .claude/skills/atlas-obscura && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
atlas-obscura
GitHub stars
688
Token cost
~1.1k tokens
SKILL.md length
419 words
Files
4
Skills in repo
46
Repo updated
First seen
Licence
MIT

At a glance

Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination.

  • SKILL.md covers Prerequisites, City Coordinates Reference, Commands and Interest Scoring, plus 2 more sections
  • Runs JavaScript scripts from its folder; calls node, jq and npm

What it does

Atlas Obscura is an agent skill from borski/travel-hacking-toolkit. Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination. Find the interesting stuff, not boring plaques. Search by coordinates, get full details with descriptions and images.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `package-lock.json` and `package.json`).

The repository describes itself as: AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode. The licence is MIT.

Example prompts

  • “/atlas-obscura”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit db82131. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • jq
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Atlas Obscura loads about 1.1k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 419 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from borski/travel-hacking-toolkit at commit db82131, republished under its MIT licence (© borski). 419 words, ~1,132 tokens.

Download SKILL.mdSave it as .claude/skills/atlas-obscura/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
atlas-obscura
description
Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination. Find the interesting stuff, not boring plaques. Search by coordinates, get full details with descriptions and images.
category
destinations
summary
Hidden gems and unusual attractions near any destination.
api_key
None (free)
license
MIT

Atlas Obscura

Find genuinely interesting hidden gems near any destination via Atlas Obscura. Searches by coordinates, scores places for interestingness, and filters out mundane historical markers.

No API key needed. Uses the atlas-obscura-api npm scraper.

Prerequisites

Install dependencies (one time):

bash
cd skills/atlas-obscura && npm install

City Coordinates Reference

Common cities for trip planning. Use these with the search commands.

CityLatLng
New York40.7128-74.0060
London51.5074-0.1278
Paris48.85662.3522
Tokyo35.6762139.6503
Bangkok13.7563100.5018
Rome41.902812.4964
Barcelona41.38742.1686
Istanbul41.008228.9784
Mexico City19.4326-99.1332
Lisbon38.7223-9.1393
Seoul37.5665126.9780
Oslo59.913910.7522
Copenhagen55.676112.5683
Stockholm59.329318.0686

Commands

All commands run from the repo root. Output is JSON. Image URLs are excluded by default to keep output lean. Add --images to any command when you need them (e.g. generating HTML pages).

Search Nearby (Filtered)

Finds places near coordinates, fetches full details, scores for interestingness, and filters out boring stuff. Slower (fetches each place) but gives you the good stuff.

bash
node skills/atlas-obscura/ao.mjs search <lat> <lng>

Example:

bash
node skills/atlas-obscura/ao.mjs search 35.6762 139.6503

Returns up to 20 places sorted by interest score. Each has full description, tags, and directions.

Timeout note: This makes ~20 HTTP requests (one per place). Allow 30-60 seconds.

Quick Search (Unfiltered)

Fast nearby search. Returns title, subtitle, coordinates, distance. No detail fetching or scoring.

bash
node skills/atlas-obscura/ao.mjs quick <lat> <lng>
Search Unfiltered with Details

Same as filtered search but keeps everything, including boring plaques.

bash
node skills/atlas-obscura/ao.mjs search <lat> <lng> --all
Full Place Details

Get complete information for a specific place by ID.

bash
node skills/atlas-obscura/ao.mjs place <id>

Returns: title, subtitle, full description (multi-paragraph), directions, tags, nearby places, interest score.

Show full SKILL.md (172 more words)Show less
Short Place Summary

Quick place lookup without the full scrape. One request.

bash
node skills/atlas-obscura/ao.mjs short <id>
Including Images

Add --images to any command to include thumbnail and image URLs in the output. Useful when generating HTML pages or visual reports.

bash
node skills/atlas-obscura/ao.mjs search <lat> <lng> --images
node skills/atlas-obscura/ao.mjs place <id> --images

Interest Scoring

Places are scored based on:

Bonus points for: Abandoned, Ruins, Ghost Towns, Underground, Caves, Natural Wonders, Unusual Collections, Street Art, Museums, Markets, Hot Springs, Waterfalls, Breweries, Gardens, Islands, Art, Sculpture, Murals. Also: rich descriptions, multiple images.

Penalties for: Plaques, Historical Markers, Monuments, War Memorials, Government Buildings. Also: places marked "gone" or hidden from maps.

Places scoring below 0 are filtered out in the default search.

Useful jq Filters

bash
# Just titles and subtitles
... | jq '.[] | {title, subtitle, tags}'

# Top 5 by interest score
... | jq '[sort_by(-.interest_score) | .[0:5] | .[] | {title, subtitle, interest_score, url}]'

# Places with specific tags
... | jq '[.[] | select(.tags | any(. == "Underground" or . == "Caves"))]'

# Just URLs for browsing
... | jq -r '.[].url'

When to Use

Load this skill when:

  • Planning trips and want to find hidden gems near destinations
  • Looking for unique, weird, or wonderful places to visit
  • Need Atlas Obscura recommendations for specific coordinates
  • Adding interesting stops to an itinerary

Do not:

  • Use for booking (AO is discovery only)
  • Hammer the scraper excessively (it's scraping atlasobscura.com, be respectful)
  • Expect real-time availability (places can close, change hours, etc.)

© borski, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in plugins/travel-hacking-toolkit/skills/atlas-obscura of borski/travel-hacking-toolkit.

  • SKILL.md
  • ao.mjs
  • package-lock.json
  • package.json

Open the folder on GitHubat commit db82131

Compare with similar skills

Atlas Obscura next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Atlas Obscura compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Atlas Obscura this skillborski/travel-hacking-toolkit688—~1.1kAutomated safety check: PassMIT
Pp Atlas Obscuramvanhorn/printing-press-library2.1k—~3kAutomated safety check: NotesApache-2.0
System AtlasNousResearch/hermes-agent253k—~2.2kAutomated safety check: PassMIT
Atlas Cloudcalesthio/OpenMontage66k—~1.2kAutomated safety check: PassAGPL-3.0
Atlas Ledgersickn33/agentic-awesome-skills47k1 repos~3.9kAutomated safety check: PassMIT
Aria Hidden Bodythedaviddias/Front-End-Checklist74k—~444Automated safety check: PassMIT

Similar skills

  • Pp Atlas Obscura

    mvanhorn/printing-press-library

    Every Atlas Obscura search, plus a local database, road-trip corridor routing Trigger phrases: weird places near me, atlas obscura, hidden gems along my route, offbeat things to do in, unusual…

    2.1k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • System Atlas

    NousResearch/hermes-agent

    Build explorable isometric architecture atlases as HTML. An agent skill from NousResearch/hermes-agent.

    253k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Atlas Cloud

    calesthio/OpenMontage

    Generate or edit images and videos through the Atlas Cloud gateway.

    66k GitHub stars~1.2k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • Atlas Ledger

    sickn33/agentic-awesome-skills

    Companion to atlas-contract. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • Aria Hidden Body

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Do not use aria-hidden on the document body.

    74k GitHub stars~444 tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Aria Hidden Focus

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Remove focusable elements from aria-hidden containers.

    74k GitHub stars~468 tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed

More from borski/travel-hacking-toolkit

All 46 skills in this repo
  • Amex Travel

    borski/travel-hacking-toolkit

    Search Amex travel portal for cash prices, MR points pricing, IAP discounts, and FHR/THC hotel benefits via Patchright.

    688 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • Chase Travel

    borski/travel-hacking-toolkit

    Search Chase UR travel portal via Patchright for cash prices, points pricing, Points Boost offers, and Chase Edit hotel benefits.

    688 GitHub stars~2.8k tokensUpdated 6 days ago
    Auto-check passed
  • Deutsche Bahn

    borski/travel-hacking-toolkit

    Deutsche Bahn train schedules, journey planning, and departures across Germany and into neighboring countries (Austria, Switzerland, Netherlands, France, Belgium).

    688 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed
  • Sutochno

    borski/travel-hacking-toolkit

    Search Sutochno.ru (СУТОЧНО.РУ), a Russian short-term apartment-rental platform where you book directly from owners and pay in rubles (Mir card / bank transfer).

    688 GitHub stars~2.1k tokensUpdated 6 days ago
    Auto-check passed
  • Ticketsatwork

    borski/travel-hacking-toolkit

    Search TicketsAtWork (EBG corporate perks) for hotels, theme park tickets, attractions, and rental cars via Patchright.

    688 GitHub stars~4.2k tokensUpdated 6 days ago
    Auto-check passed
  • Vrbo

    borski/travel-hacking-toolkit

    Search VRBO (Vrbo / Expedia Group) vacation rentals including entire homes, condos, and cabins via Patchright browser automation.

    688 GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed

Questions about Atlas Obscura

What does Atlas Obscura do?

Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination. Atlas Obscura is an agent skill from borski/travel-hacking-toolkit. Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination.

How do I install Atlas Obscura in Claude Code?

Run `npx skills add borski/travel-hacking-toolkit --skill atlas-obscura -a claude-code`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/atlas-obscura in borski/travel-hacking-toolkit) into .claude/skills/atlas-obscura in your project. Claude Code loads it when a task matches its description.

How do I install Atlas Obscura in Codex?

Run `npx skills add borski/travel-hacking-toolkit --skill atlas-obscura -a codex`. Or copy the skill folder (plugins/travel-hacking-toolkit/skills/atlas-obscura in borski/travel-hacking-toolkit) into .agents/skills/atlas-obscura in your project. Codex loads it when a task matches its description.

Can I use Atlas Obscura in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borski/travel-hacking-toolkit --skill atlas-obscura -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/atlas-obscura, .gemini/skills/atlas-obscura, .github/skills/atlas-obscura and .opencode/skills/atlas-obscura in your project.

What does Atlas Obscura need to run?

Going by SKILL.md and its folder, Atlas Obscura needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node, jq and npm). Our summary lists: Node.js.

Does Atlas Obscura access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Atlas Obscura safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Atlas Obscura use?

Atlas Obscura is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Atlas Obscura use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Atlas Obscura?

Skills that share tags, products or a category with Atlas Obscura: Pp Atlas Obscura (mvanhorn/printing-press-library, 2.1k stars), System Atlas (NousResearch/hermes-agent, 253k stars), Atlas Cloud (calesthio/OpenMontage, 66k stars) and Atlas Ledger (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Atlas Obscura?

borski (a GitHub user) maintains it in borski/travel-hacking-toolkit, which has 688 GitHub stars. The repository holds 46 skills in this directory. The repository was last updated on October 5, 2026.

Source: borski/travel-hacking-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.