Agent Skill

Geo Sleuth skill

geo-sleuthOldcircle/geo-sleuthskills/geo-sleuth/SKILL.md

Geolocate or chronolocate a photo with tool-verified reasoning (where was this taken / when was it taken / photo geolocation / geo-guessing). Given one or more photos, intake.py does metadata, OCR and reverse image search (Baidu/Yandex) in one command; clues and candidates go on a candidate board (board.py) that ranks them and gives the next step; clues.py looks up calling codes, driving side, plates and area codes from region packs; for satellite and street view the machine ranks first and you look only at the top few (CLIP in sat_scan.py, DINOv2+SIFT in match.py); plus sun and shadow math, OSM Overpass and DEM skylines. Every conclusion is checked against real data; output is coordinates + error radius, evidence images and tiered confidence. Use when the user shares a photo and asks where was this taken / geolocate this / when was this taken / 这是哪 / 在哪拍的 / 帮我定位这张照片 / 网络迷踪 / 图寻 / 几点拍的.

3.8kMIT

always on

231 tokname + description

once used

6,130 tokSKILL.md body

bundled files

8433 scripts

repo stars

3.8kGitHub

Install the Geo Sleuth skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/Oldcircle/geo-sleuth --skill geo-sleuth

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/Oldcircle/geo-sleuth.git /tmp/geo-sleuth
mkdir -p ~/.claude/skills
cp -R /tmp/geo-sleuth/skills/geo-sleuth ~/.claude/skills/geo-sleuth

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

When	What loads	Cost
Every session	Name and description	231 tok
When the agent uses it	The SKILL.md instructions	6,130 tok
Only if opened	84 bundled files (1.5 MB)	varies

Until it is used, geo-sleuth costs about 5.9× less than the median MCP server we measured (1,363 tokens on every turn). Skills vs MCP study

Checks

Ships scripts the agent can run. Read them before installing.
The instructions are over 5,000 tokens, the Agent Skills specification's guideline for SKILL.md.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

geo-sleuth (v2)
Hard rules (always in force; ★ = enforced by board.py, just follow it)
Flow
Step 1: steps 0–3 in one command
Step 2: list all candidates, score evidence, check the next step
Step 3: pick a branch to narrow down
Step 4: finding the spot in satellite imagery — the machine ranks first
Step 5: confirmation — street view is ranked first too
Step 6: fix the camera position and write the output
Budget and stopping conditions
Runtime environment