DenisSergeevitch/ex-ussr-kinship-research

What is it?

Key features

• 01Traces every claim to its artifacts and assigns explainable evidence statuses.
• 02Resolves events to the historical jurisdiction and record custodian as of the event date.
• 03Generates name-variant matrices for Russian, Ukrainian, Polish, German and Yiddish forms.
• 04Audits CSV registers for referential integrity and uncorroborated claims.
• 05Produces HTML family reports and GEDCOM 5.5.1 or 7 exports with source notes.

Use cases

• Finding a great-grandparent's parents in church or civil registers from the former USSR.
• Checking whether scanned marriage certificates and military cards refer to the same person.
• Locating the parish or FamilySearch film for a village and period before reading its births.
• Drafting requests to regional archives and exporting the resulting tree to genealogy software.

Quick start

1. 1

   Clone the repository into your agent's skills folder (Codex example)

   git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.codex/skills/ex-ussr-kinship-research
2. 2

   Initialize a private case folder outside the skill checkout

   python scripts/init_case.py --case-dir ~/kinship-cases/my-case --research-question "Who were Maria's parents?" --subject-label "Maria"
3. 3

   Check the registers before writing the final report

   python scripts/audit_evidence.py --case-dir ~/kinship-cases/my-case

Things to know

• !Coverage is tied to archive availability; regional examples do not replace local research.
• !Indexed records and some archives require sign-in or a lawful browser session and may be restricted.
• !Mail sending and FamilySearch tree changes need explicit authorization and separate tooling.

In collections

Topics

FAQ

What is ex-ussr-kinship-research?

An evidence-first genealogy skill for AI agents that researches family history across former USSR records, with traceable sources. ex-USSR Kinship Research is an agent skill for Codex, Claude Code and other Agent Skills runtimes that turns an AI agent into a family-history researcher for the former Soviet Union and Russian Empire. It covers church books, civil registration, military, deportation and repression files, and unindexed archive scans across all 15 former Soviet republics.

Is ex-ussr-kinship-research free to use? What license does it have?

ex-ussr-kinship-research is open source under the MIT license. Check the license terms before using it in commercial products.

Is ex-ussr-kinship-research still maintained?

Actively maintained. The last commit to ex-ussr-kinship-research was on Nov 6, 2026.

What can I use ex-ussr-kinship-research for?

Finding a great-grandparent's parents in church or civil registers from the former USSR. Checking whether scanned marriage certificates and military cards refer to the same person. Locating the parish or FamilySearch film for a village and period before reading its births. Drafting requests to regional archives and exporting the resulting tree to genealogy software.

How do I install ex-ussr-kinship-research?

Clone the repository into your agent's skills folder (Codex example): git clone https://github.com/DenisSergeevitch/ex-ussr-kinship-research ~/.codex/skills/ex-ussr-kinship-research Initialize a private case folder outside the skill checkout: python scripts/init_case.py --case-dir ~/kinship-cases/my-case --research-question "Who were Maria's parents?" --subject-label "Maria" Check the registers before writing the final report: python scripts/audit_evidence.py --case-dir ~/kinship-cases/my-case

Where can I get ex-ussr-kinship-research?

The source code and installation instructions are on GitHub: https://github.com/DenisSergeevitch/ex-ussr-kinship-research