similarity-matcher

Rank nearby archaeological sites by distance, period overlap, and artifact-type similarity.

Updated Nov 12, 2025
One-click install
npx skills add https://github.com/younga1234/20251112-3 --skill similarity-matcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: similarity-matcher
Source: https://github.com/younga1234/20251112-3/tree/main/.claude/skills/similarity-matcher
Command: npx skills add https://github.com/younga1234/20251112-3 --skill similarity-matcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifying and comparing relevant nearby archaeological sites for research is a laborious task, often requiring extensive database searches and complex geographical analysis. This Skill automates the matching and ranking process.

Core Features & Use Cases

  • Geospatial Matching: Utilizes the Haversine formula to calculate distances and identify sites within a specified radius of your target area.
  • Multi-criteria Similarity: Compares sites based on spatial proximity, historical period, and the types of artifacts or features found.
  • Use Case: Quickly find the top 10 most similar archaeological sites to your current excavation, complete with summaries and key comparison points, to enrich the "Discussion" section of your report.

Quick Start

Use the similarity-matcher skill to find and compare similar sites within 20km of my excavation. Target site info:

  • Name: ○○ Site Excavation
  • Coordinates: Lat 37.5665, Lon 126.9780
  • Periods: Bronze Age, Proto-Three Kingdoms
  • Types: Pit-dwellings, Pits, Plain pottery

Frequently Asked Questions about similarity-matcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find similar archaeological sites near my excavation location?

Similarity-matcher identifies nearby archaeological sites by calculating distance using the Haversine formula, then ranks them by spatial proximity, historical period overlap, and artifact-type similarity. Provide your target site's coordinates, time periods, and artifact types to get a ranked list of comparable sites within your specified radius.

What factors does the tool use to compare archaeological sites?

The tool compares sites across three dimensions: geographic distance via Haversine calculation, temporal overlap using Jaccard similarity for periods, and artifact-type matching via set-based overlap. It combines these into a single score to rank results by overall similarity.

Can I use this to support comparative analysis in my research report?

Yes. Similarity-matcher returns top-ranked results with metadata, summaries, and provenance information, specifically designed to enrich comparative discussion sections by quickly surfacing the most relevant nearby sites for your excavation context.

What input data do I need to provide for site matching?

Provide your target excavation's name, geographic coordinates (latitude and longitude), the historical periods represented, the artifact and feature types found, and your desired search radius. The tool then queries surrounding sites and ranks matches by combined similarity.

What does the final output include for each matched site?

Each result includes the matched site's metadata, a summary of its characteristics, distance and similarity scores, temporal period information, artifact types, and provenance details to support your comparative analysis and citation needs.