Surname Cluster Analyzer

Classify surnames in the AADNA database as monohaplogroup or polyhaplogroup using Y-DNA data.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/valalav/aadna_bot --skill surname-cluster-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Surname Cluster Analyzer
Source: https://github.com/valalav/aadna_bot/tree/main/skills/surname_cluster
Command: npx skills add https://github.com/valalav/aadna_bot --skill surname-cluster-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps analyze surname clusters within DNA databases to determine if a surname is associated with a single haplogroup (monohaplogroup) or multiple haplogroups (polyhaplogroup), providing insights into genealogical origins and family structures.

Core Features & Use Cases

  • Haplogroup Classification: Identifies surnames as monohaplogroup or polyhaplogroup based on Y-DNA data.
  • Lineage Analysis: Differentiates between single-branch and multi-branch monohaplogroup lines.
  • Use Case: A user can input a surname, and the Skill will analyze all individuals with that surname in the AADNA database, reporting on the distribution of their Y-DNA haplogroups and classifying the surname's genetic profile.

Quick Start

Analyze the surname 'Smith' to determine its haplogroup distribution.

Frequently Asked Questions about Surname Cluster Analyzer

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

FAQPage Schema
How do I analyze surname haplogroup patterns in Y-DNA data?

A polyhaplogroup surname indicates multiple Y-DNA haplogroups are associated with that surname. This classification reveals multiple distinct paternal lineages sharing the same surname, contrasting with monohaplogroup surnames which trace back to a single paternal origin.

Can I use this to check if a surname has a single or multiple haplogroup lines?

To determine haplogroup distribution, input a surname and the Skill analyzes all matching individuals in the AADNA database. It collects Y-DNA data, determines the cluster type, and provides a detailed interpretation of the haplogroup distribution for that surname.

What is the difference between single-branch and multi-branch monohaplogroup lines?

Single-branch and multi-branch monohaplogroup lines represent different structures within a single Y-DNA haplogroup. The lineage analysis differentiates these branching patterns to provide deeper understanding of how a surname's paternal lineage evolved over time.

Does this surname cluster analysis work with the AADNA database?

Yes, this surname cluster analysis works directly with the AADNA database. It processes the Y-DNA data stored in AADNA to identify surname clusters and classify their haplogroup patterns for genealogical research and paternal lineage understanding.