junowoz/genealogy-researcher

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "genealogy-researcher",
  "version": "1.0.0",
  "description": "Evidence-first family history research for ChatGPT and Codex. Search GEDCOM trees, analyze ancestry, find open records and keep a shared research log.",
  "author": {
    "name": "Juno Woz",
    "email": "inbox@junowoz.com",
    "url": "https://junowoz.com"
  },
  "homepage": "https://genealogy.junowoz.com",
  "repository": "https://github.com/junowoz/genealogy",
  "license": "MIT",
  "keywords": ["genealogy", "family-history", "gedcom", "research", "ancestors", "paleography"],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Genealogy Researcher",
        "shortDescription": "Evidence-first family history",
        "longDescription": "Genealogy Researcher helps you research your family history with sources and stated uncertainty.\n\nUpload a GEDCOM file exported from Ancestry, MyHeritage, Geni, RootsMagic, Gramps, Legacy, MacFamilyTree, Family Tree Maker or WikiTree. The plugin keeps the tree private in your account. The assistant can then search people, read facts and sources, list ancestors and descendants, explain how two people are related and report data problems such as impossible dates. The oldest ancestor and the longest line are reported as two separate results.\n\nFor records outside your tree, the plugin searches public WikiTree profiles, the Internet Archive, Chronicling America, Open Archives and Wikidata. It also builds search links for archives such as Antenati, Digitarq, FreeBMD and Find a Grave. A link is not a record, and the plugin never claims that a search was exhaustive.\n\nResearch projects keep questions, plans, search logs, evidence, hypotheses and conclusions. You can invite other researchers as editors or viewers and share a tree with a project.\n\nThree skills come with the plugin. One applies the Genealogical Proof Standard and source citation. One guides the reading of old handwritten records in Portuguese, Spanish, Latin and Italian from images you provide. One explains how to export a GEDCOM file from each platform.\n\nLimits: the plugin does not write to any external tree, does not search private archives and does not analyze DNA. FamilySearch support is planned, pending FamilySearch's authorization. No FamilySearch data is available today. Tree data and AI output are leads, not proof. Check every conclusion against the cited records.",
        "developerName": "Juno Woz",
        "category": "Education & Research",
        "capabilities": [
          "Create a secure link to upload a GEDCOM tree",
          "Search people and read facts and sources",
          "List ancestors and descendants",
          "Explain how two people are related",
          "Report the oldest ancestor and the longest line",
          "Check a tree for data problems",
          "Search public WikiTree profiles",
          "Search open archives and build record search links",
          "Keep research logs in shared projects",
          "Guide the reading of old handwritten records"
        ],
        "websiteURL": "https://genealogy.junowoz.com",
        "supportURL": "https://genealogy.junowoz.com/support",
        "privacyPolicyURL": "https://genealogy.junowoz.com/privacy",
        "termsOfServiceURL": "https://genealogy.junowoz.com/terms",
        "defaultPrompt": [
          "Qual é o ancestral mais antigo de uma pessoa da minha árvore e qual é a linha mais longa?",
          "How are two people in my tree related? Show the path and the sources.",
          "Transcreva esta certidão de batismo antiga e extraia pais e padrinhos."
        ],
        "brandColor": "#B7791F",
        "brandColorDark": "#E8A94A",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "onboardingSkill": "./skills/getting-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a person and inspect sources",
              "prompt": "Search my tree for people with the surname Silva born around 1890 and show the sources for the best match.",
              "tools_triggered": "search_people, get_person",
              "expected_behavior": "Lists candidates with person refs, dates and places, then returns the facts and source citations of the chosen person. States that tree data is a lead and does not assert an identity from the name alone. Cites only refs and URLs returned by the tools."
            },
            {
              "description": "Oldest ancestor versus deepest line",
              "prompt": "Who is the oldest ancestor of Marina Barros da Silva in my tree, and which of her lines goes back the most generations?",
              "tools_triggered": "search_people, analyze_tree",
              "expected_behavior": "Finds Marina Barros da Silva, then reports the oldest dated ancestor and the deepest line as two separate results, each with its path. States generation limits, approximate dates and any truncated search. Does not treat a bounded result as complete."
            },
            {
              "description": "Relationship between two people",
              "prompt": "How are Antônio Rossi da Silva and Giuseppe Rossi da Silva related in my tree? Show the path.",
              "tools_triggered": "search_people, find_relationship",
              "expected_behavior": "Finds both people, then returns the relationship label, the common ancestors and the path between them. If no path is found, says that none was found within the searched limits and does not claim that the two are unrelated."
            },
            {
              "description": "Record leads and search links",
              "prompt": "Find open records and archive search links for Giuseppe Rossi, born around 1870 near Treviso, Italy.",
              "tools_triggered": "search_records, get_research_links",
              "expected_behavior": "Returns results with their source names and URLs, plus search links for relevant archives. Calls the results leads, reports any source that failed, and does not claim that the search was exhaustive."
            },
            {
              "description": "Research log in a shared project",
              "prompt": "Create a research project for the Silva family question, log that I searched the 1900 census with no result, and make a view-only invite link for my cousin.",
              "tools_triggered": "create_project, add_research_entry, share_project",
              "expected_behavior": "Creates the project, adds a search log entry with the outcome not found, and creates a viewer invite link with an expiry date. Tells the user that anyone with the link can join until it expires or reaches its use limit."
            }
          ],
          "negative": [
            {
              "description": "Should not write to an external tree: the plugin cannot change FamilySearch or any other external tree. The assistant explains the limit and offers to record the suggested correction as a hypothesis in a research project.",
              "prompt": "Change the birth year of Maria on my FamilySearch tree to 1892 and merge the duplicate profiles."
            },
            {
              "description": "Should not expose another user's private tree: each user reaches only their own trees and trees shared with them through a project. The assistant explains that access needs an invitation from the owner.",
              "prompt": "Show me the private family tree that my neighbor Wilhelmina Oosterhuis uploaded to this plugin."
            },
            {
              "description": "Should not claim to search or transcribe the whole FamilySearch archive: no FamilySearch data is available and the plugin does not bulk-search archives. The assistant explains the limit, offers archive search links and offers to read images the user provides.",
              "prompt": "Search the entire FamilySearch historical records archive and transcribe every image about the Silva family in Minas Gerais."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "1.0.0: First release. GEDCOM upload and search, ancestry analysis, relationship finder, WikiTree and open archive search, research projects, and three skills. FamilySearch is not available.",
        "translations": {
          "pt-BR": {
            "subtitle": "História familiar com fontes",
            "description": "O Genealogy Researcher ajuda você a pesquisar a história da sua família com fontes e com a incerteza declarada.\n\nEnvie um arquivo GEDCOM exportado do Ancestry, MyHeritage, Geni, RootsMagic, Gramps, Legacy, MacFamilyTree, Family Tree Maker ou WikiTree. O plugin guarda a árvore em privado na sua conta. O assistente pode então buscar pessoas, ler fatos e fontes, listar ancestrais e descendentes, explicar o parentesco entre duas pessoas e apontar problemas nos dados, como datas impossíveis. O ancestral mais antigo e a linha mais longa aparecem como dois resultados separados.\n\nPara registros fora da sua árvore, o plugin busca perfis públicos do WikiTree, Internet Archive, Chronicling America, Open Archives e Wikidata. Também monta links de busca para arquivos como Antenati, Digitarq, FreeBMD e Find a Grave. Um link não é um registro, e o plugin nunca afirma que uma busca foi completa.\n\nProjetos de pesquisa guardam perguntas, planos, registros de busca, evidências, hipóteses e conclusões. Você pode convidar outros pesquisadores como editores ou leitores e compartilhar uma árvore com um projeto.\n\nO plugin inclui três habilidades. Uma aplica o Padrão de Prova Genealógica e a citação de fontes. Outra orienta a leitura de registros antigos manuscritos em português, espanhol, latim e italiano, a partir de imagens que você fornece. A terceira explica como exportar um arquivo GEDCOM de cada plataforma.\n\nLimites: o plugin não escreve em árvores externas, não busca em arquivos privados e não analisa DNA. O suporte ao FamilySearch está planejado e depende da autorização do FamilySearch. Hoje não há dados do FamilySearch. Dados de árvore e respostas de IA são pistas, não prova. Confira cada conclusão nos registros citados."
          }
        }
      }
    }
  }
}