A free skill turns Claude Code or Codex into an archive genealogist for 15 countries
Denis Shiryaev released ex-USSR Kinship Research free under MIT on Oct 25, 2026 and it passed 690 GitHub stars by the next morning. It makes a coding agent an evidence-first family-history researcher for all 15 former Soviet republics.
Published Oct 26, 2026
The Wow
What someone built
An Agent Skill with case intake, CSV registers for persons, claims and searches, a historical-jurisdiction model, name-variant matrices across six languages, claim statuses from hypothesis to strongly corroborated, an evidence audit script and a PDF report.
- Made by
- Denis Shiryaev on GitHub (not us)
- Original repository
- ex-USSR Kinship Research (GitHub, MIT, Oct 25, 2026)
- License
- MIT. Free to use, change and use commercially with the copyright notice kept
- What you need
- Claude Code, Codex or another Agent Skills runtime
- Python 3 (standard library only)
- Chrome, Chromium or Edge for the PDF report
- Your own sign-ins to the record sites you use
- Install
- Clone the repo into your agent's skills folder (~/.claude/skills/ for Claude Code or ~/.codex/skills/ for Codex), then describe the family question; steps in the README.
- A business you could build on it
- Diaspora ancestry desk
Why it's remarkable
It treats genealogy like an audit: copies of one record never count as two proofs, and a script checks every claim before the report is written. It also refuses to look up living people.
The Opportunity
The business it reveals
A fixed-price ancestry desk for one diaspora community, where specialists publish rates around €40 an hour with 20-hour minimums.
Who would pay
Diaspora families with a name, a village and a story but no records, and genealogists with a backlog.
The Flip
3 ways you could turn this into a business
Diaspora ancestry desk
- Who pays
- Families with roots in one region, such as Ukraine or the Baltics
- How it would earn
- A fixed price per family case with archive fees passed through (our hypothesis; specialists list about €40 an hour with a 20-hour minimum, or about $290 an archive day)
- Why it might work
- Published specialist prices show families already pay hundreds to thousands per case, and the agent does the catalog and register work that eats those hours.
- What already exists
- Regional genealogists and agencies, DIY research on record sites, and DNA-test matches.
Same skill pattern for another region
- Who pays
- Irish, Italian, Mexican or German-heritage families
- How it would earn
- Build an evidence-first skill for one region's archives and sell cases or the skill set-up to genealogists (our hypothesis)
- Why it might work
- The skill's structure (jurisdiction model, name variants, claim statuses, audit) carries over; only the sources and locale guide change.
- What already exists
- Big record sites' hint tools and regional genealogists.
Desk-research assistant for genealogists
- Who pays
- Professional genealogists with a case backlog
- How it would earn
- A per-case fee to deliver the registers, name-variant matrix and archive request drafts they finish themselves (our hypothesis)
- Why it might work
- Specialists bill by the hour and are booked out; handing them a structured starting file frees hours they can bill elsewhere.
- What already exists
- Junior assistants and the genealogist doing it alone.
Why we'd try "Diaspora ancestry desk" first: Families in a diaspora community talk to each other, one moving report travels by word of mouth, and the skill already handles the hardest part: keeping every claim traceable.
Build It
How you could build it
A fixed-price family case for one diaspora community: intake, agent search and registers, your review of every conclusion, archive requests for missing records, and a readable PDF report.
First step: Install the skill and run one case for your own family or a friend's, starting from a single name and village. Time it and count how many claims end up corroborated versus single-source.
Agents and tools
- ex-USSR Kinship Research
- Claude Code or Codex (or another skills-capable agent; ChatGPT, Gemini or Grok Bot can help with translation checks)
- Python 3 and Chrome
- Record-site accounts the case needs
Setup
- Install the skill and run a test case on a family you know.
- Write a one-page intake form: names, dates, places, what's off-limits.
- Set one case price and list archive fees as pass-through.
- Review every claim's status before the report goes out.
- Offer three founding-price cases in one community group.
What the agent does
- Searches catalogs and scans
- Builds name variants
- Keeps the evidence registers
- Drafts the report and archive requests
What you do
- Runs intake with the family
- Signs in and orders records
- Judges conflicting evidence
- Delivers the report with care
Your first customer: A family in your community with a name, a village and a story, offered a founding-price case for a testimonial.
Test demand first: Run two test cases for people you know. Success: each ends with at least one corroborated new ancestor or a concrete archive request, and both families say they'd recommend it.
Your starter instructions
Paste this into the AI agent you use (ChatGPT, Claude, Gemini, Grok Bot or another) as your first message. Copying it starts work in your own agent; it doesn't create or deploy a business by itself.
Running it
What stays human: Client intake, signing in to record sites, ordering records from archives, judging conflicting evidence, checking translations and delivering the report.
- Startup cost (estimate)
- About $20 a month for an AI plan to start (estimate) (Estimate: the skill is free under MIT and needs only Python; an AI coding-agent plan is the main cost. Record-site subscriptions and archive fees are extra and vary by case)
- Running cost
- An AI plan plus per-case archive fees (estimate) (Rough estimate, not measured: archives charge their own copying and request fees, which you'd pass through to the client)
- How much the agent runs
- Agents run one core part; people run the rest.
Pricing your own version? Use the free startup-cost worksheet.
The evidence
What the source shows: The project README and GitHub stats (checked Oct 26, 2026). We read the README; we haven't run a case. Specialist rates are from their own pricing pages.
What's ours: The desk, its pricing and the flips are our application.
Worth planning around
- Released Oct 25, 2026; expect changes.
- Many records are only in physical archives, so some cases end with requests rather than answers.
Sources
- ex-USSR Kinship Research README (GitHub, Oct 2026)
- Historical Bureau: Ukraine and Eastern Europe research pricing
- Ukrainian Homecoming: archive research day pricing
Sources reopened Oct 26, 2026. Spot a mistake? Tell us and we'll correct it in public.
Keep reading
- How much of the work do AI agents actually run? (guide)
- He still can't write code. His five-person ad agency now runs on about 270 tools he built with Claude. Every owner-run firm needs its first five
- A marketer who doesn't code built an elk-call coaching app with Claude Code and says it hit a $650K run rate in 110 days. Every skill learned by sound is the same opening
- A free n8n workflow flags fake supplier invoices before anyone pays them — and Germany's e-invoice switch makes it a service bookkeepers can sell
- Marc Lou's agent chased a broken-shoe refund through three support desks and got his 850 AED back. Small stores now need a claims desk that can answer agents
- Every discovery and launch plan