dejiny-domu — Claude Code plugin for house history
The dejiny-domu Claude Code plugin researches a house and village through Czech archives. It turns the findings into a website with a timeline and linked historical records.
MIT ★ 78 updated 2026-11-15
/plugin marketplace add vzoha/dejiny-domu-skill
/plugin install dejiny-domu@dejiny-domu-skillWhat dejiny-domu does
The plugin takes a house-history project from the information already known to archival research and a finished website. It works with census records, parish registers, cadastral records, old maps and newspapers, and helps read, crop, transcribe and translate archival images. The research follows a house number and the people who lived there, rather than one person’s family tree.
The project includes guidance, reference material, Python tools and an Astro website template. Each published fact links to a source, and uncertain details are marked; AI can still misread a name or connect a record to the wrong house. It requires Claude Code with a paid Claude subscription, Python 3, Node.js, ImageMagick and git. Netlify is optional for publishing, as is a Europeana key for searching historical images.
What it helps with
- trace a house’s owners and residents through archives
- match historic house numbers to archival records
- transcribe and translate fragments of historical documents
- build a house-history website with links to sources
Example prompts for the agent
- Research the history of house number 12 in Horní Lhota.
- Build a timeline of the people who owned and lived in this house from archival records.
- Create a website about this house and link its claims to sources.
How to install dejiny-domu
Plugin marketplace
/plugin marketplace add vzoha/dejiny-domu-skill/plugin install dejiny-domu@dejiny-domu-skillStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about dejiny-domu
How do I install dejiny-domu in Claude Code?
Run these commands in order: /plugin marketplace add vzoha/dejiny-domu-skill, then /plugin install dejiny-domu@dejiny-domu-skill. Restart Claude Code after installation.
What does dejiny-domu do?
It guides research into a house and village using Czech archives, helps transcribe archival records, and creates a website with a timeline and source links.
What does dejiny-domu need to run?
It requires Claude Code with a paid Claude subscription, Python 3, Node.js, ImageMagick and git. Netlify for publishing and a Europeana key for finding historical images are optional.
Source text
SKILL.md · MIT
# Dějiny domu – skill pro Claude Code
Claude vás provede **dějinami vašeho domu, chalupy nebo statku a celé vsi**: od toho, co o domě víte, přes digitalizované
archivy (sčítání lidu, matriky podle čísla domu, stabilní katastr se jmény majitelů, gruntovní knihy, staré mapy,
noviny, literatura) až
k webu s časovou osou domu, držiteli, obyvateli, výřezy původních zápisů s přepisem a překladem a porovnáním starých map.
Je určený pro lidi, kteří v archivu nikdy nebádali a neprogramují – technickou práci dělá Claude, vy dodáváte znalost
místa a rozhodujete.
Skill je odvozený ze skillu [**rodokmen**](https://github.com/sarsonj/rodokmen-skill) Jindřicha Šaršona (verze 0.5.0).
Nástroje na archivy, čtení snímků, výřezy, deník hledání a web jsou společné; rozdíl je v tom, že se data točí kolem
**čísla popisného** a lidí, kteří v domě v čase žili a vlastnili ho, ne kolem předků jedné osoby. Děkuji autorovi
rodokmenu za skvělý základ.
**Aktuální verze: 0.13.0 (listopad 2026), rané vydání.** Skill vznikl při zjišťování dějin jednoho domu a zatím byl
vyzkoušený na řadě domů na vsi i ve městě, v Čechách i na Moravě (Linux). Počítejte s chybami a dejte mi o nich vědět.
## Dějiny domu na zakázku
Nechcete to dělat sami? Dějiny vašeho domu zpracuji na zakázku. Bádám s tímto skillem a nejdůležitější zápisy ověřím
v originále. Dostanete PDF s odkazy na prameny, od 1 900 Kč. Nejdřív zdarma ověřím, co se k vašemu domu dochovalo.
Ukázky PDF, ceny a jak to probíhá najdete na **[www.historiedomu.cz](https://www.historiedomu.cz/)**. Rovnou se můžete
[zeptat na svůj dům](https://www.historiedomu.cz/poptavka/?zdroj=github).
## Ukázka
**Živá ukázka: [historie.malystatek.cz](https://historie.malystatek.cz/)**. Tento web vznikl se skillem a popisuje
výměnek čp. 30 a statek čp. 1 v Lništi (obec Slavče, okres České Budějovice).

<table><tr>
<td><img src="docs/ukazka_pribehy.jpg" alt="Rozcestník příběhů domu, statku a vsi"></td>
<td><img src="docs/ukazka_dum.jpg" alt="Stránka domu čp. 30 s časovou osou a odkazy na prameny"></td>
</tr><tr>
<td>Příběhy domů a vsi vyprávěné od začátku do dneška</td>
<td>Stránka domu: časová osa, každý údaj má odkaz na pramen</td>
</tr></table>
> **Než začnete**
>
> Skill **nenahrazuje historika ani zkušeného badatele**. Umělá inteligence dělá chyby: špatně přečte jméno, splete
> si dva Jany ze stejné vsi nebo přiřadí zápis k jinému domu (čísla domů se v 19. století měnila). Skill se tomu
> snaží bránit – u každého údaje je zdroj a výřez původního zápisu a nejisté věci jsou označené. Za správnost ale
> ručíte vy.
## Co budete potřebovat
- **Claude Code** (aplikace nebo příkazová řádka) a placené předplatné Claude. Bádání je dlouhá práce a spotřebuje
dost kreditů; tarif Pro stačí na vyzkoušení.
- Programy **Python 3, Node.js, ImageMagick a git**. Claude zkontroluje, co chybí, a pomůže s instalací.
- Volitelně účet na [Netlify](https://www.netlify.com) (zdarma), pokud chcete web zveřejnit.
- Volitelně osobní klíč [Europeany](https://pro.europeana.eu/page/get-api) (zdarma) na staré obrázky obce. Klíč zůstane uložený u vás a posílá se jen Europeaně.
z evropských sbírek. Claude vám řekne, kde ho získat.
## Instalace
### Varianta A – jako plugin (doporučeno)
V Claude Code napište:
```
/plugin marketplace add vzoha/dejiny-domu-skill
/plugin install dejiny-domu@dejiny-domu-skill
```
Pak Claude Code restartujte. Aktualizace později: `/plugin marketplace update dejiny-domu-skill`. Rozpracovaný projekt
pak Claude sám nabídne aktualizovat (vaše data zůstanou).
### Varianta B – přes `npx skills` (i pro jiné agenty než Claude Code)
V terminálu (potřebuje Node.js):
```
npx skills add vzoha/dejiny-domu-skill
```
### Varianta C – ručně
Stáhněte repozitář a zkopírujte složku `skills/dejiny-domu` do `~/.claude/skills/` (na Windows
`C:\Users\<jméno>\.claude\skills\`). Výsledek: `~/.claude/skills/dejiny-domu/SKILL.md`. Pak Claude Code restartujte.
## První spuštění
1. Spusťte Claude Code a napište třeba *„Chci zjistit historii našeho domu, čp. 12 v Horní Lhotě.“* nebo `/dejiny-domu`.
2. Claude zkontroluje programy, založí složku projektu a začne se ptát, co o domě víte. Připravte si kupní smlouvy,
staré fotky, výpisy z katastru, knihy o obci a co vyprávěli sousedé.
3. **Příště otevírejte Claude Code přímo ve složce projektu.** Claude si přečte, kde jste skončili, a naváže.
## Jak to probíhá
| Fáze | Co děláte vy | Co dělá Claude |
|---|---|---|
| 0. Příprava | potvrdíte instalaci programů | založí projekt, ověří dnešní obec a parcelu (RÚIAN) |
| 1. Co už víme | dodáte dokumenty a vzpomínky | zapisuje, čte knihy a dokumenty |
| 2. Kostra | – | zjistí farnost, panství, archiv a čísla domu v čase |
| 3. Prameny | rozhodujete sporná místa | sčítání lidu, matriky, katastry, gruntovní knihy: stahuje, čte, dělá výřezy, přepisy a překlady, vede deník |
| 4.–5. Obec a příběhy | doplníte místní historky, schválíte texty | dějiny obce, zajímavosti, příběh domu |
| 6.–7. Web | díváte se a říkáte, co upravit; schválíte zveřejnění | staví web, ukazuje náhled, nasadí ho |
## Co je v repozitáři
```
skills/dejiny-domu/
SKILL.md průvodce pro Clauda (fáze, pravidla)
reference/ návody: prameny k domu a obci, čtení matrik, portály archivů, formát dat, web, texty, soukromí
tools/ nástroje v Pythonu (archivy, Archiv ČÚZK, RÚIAN, staré obrázky a mapy, výřezy, rámečky,
kontrola dat, export do webu)
template/ šablona projektu: prázdná data a web (Astro)
.claude-plugin/ instalace jako plugin
```
## Komunitní sdílení (volitelné)
Spousta lidí čte tytéž matriky. Claude se proto před otevřením knihy podívá do dvou otevřených projektů:
[Mapa matrik](https://github.com/ondrnovy/mapa-matrik) (kde v knize začíná který rok nebo ves, bez jmen) a
[index matrik](https://github.com/pe-pan/matriky-index) (zápisy, které už někdo přečetl). Ušetří to hledání, kredity
i servery archivů. Co v indexu je, bere jen jako vodítko a vždy si to přečte na snímku. Po prvním kole se vás
**jednou** zeptá, jestli může na oplátku sdílet, co sám přečetl: jen mapu (bez jmen), mapu i přepisy, nebo nic.
Bez vašeho souhlasu nic neodešle. Nástroj převzatý ze skillu Rodokmen (díky ondrnovy).
## Soukromí
Projekt zůstává na vašem počítači. Claude má pokyn nedávat na web údaje o žijících lidech a dnešních majitelích bez
souhlasu a před zveřejněním s vámi projít, co web říká – rozhodnutí je ale na vás. Pokud projekt zálohujete na GitHub,
použijte **soukromý** repozitář.
Databáze obětí nacismu obsahuje citlivé údaje a chce při vstupu souhlas s podmínkami. Ten potvrzujete vy sami
v terminálu, Claude ho za vás nepotvrdí.
## Bezpečnost
Skill je text (návod pro Clauda) a skripty v Pythonu, které si můžete před instalací prohlédnout. Plugin nemá hooky ani
MCP servery; skripty spouští jen Claude, když je potřebuje, a Claude Code se vás na ně zeptá. Zapisují do složky
projektu, jen společný limit rychlosti k archivům si drží stav ve `~/.cache/dejiny-domu/`. Do projektu skill zapíše
hook (`.claude/settings.json` → `tools/hlidac.py`), který Claudovi nedovolí posílat na weby dotazy mimo ten limit –
archivy po sérii rychlých dotazů blokují IP adresu. Chodí na:
- archivní portály, které to dovolují (ARON, AHMP, eBadatelna SOA Praha a MZA Brno – jen hledání, SOA Litoměřice
– obrázkový server, Matricula, policejní přihlášky Národního archivu, sčítání Brna, Národní archivní portál);
kde archiv nástroje nepouští (ZA Opava, snímky eBadatelny), otevřete snímek v prohlížeči vy,
- mapy a úřední data (Archiv ČÚZK, ortofota ČÚZK a krajů, RÚIAN, CENIA, Geolab, IPR Praha, OpenStreetMap, ARES
a obchodní rejstřík),
- noviny a knihy (ANNO, Kramerius, Česká digitální knihovna),
- památky a sbírky (Památkový katalog a MIS NPÚ, eSbírky, Fotobanka Seidel, Industriální topografie,
translokační plány ČVUT, Wikimedia Commons, Europeana, Deutsche Digitale Bibliothek, pohlednice AKON
Rakouské národní knihovny, zanikleobce.cz),
- evidence válečných hrobů MO, hřbitovní pasporty obcí na GisOnline.cz a Databáze obětí nacismu (holocaust.cz),
- při instalaci webu do registru npm; na Netlify jen tehdy, když web sami zveřejníte.
Texty stažené z webů (články, komentáře, OCR) má Claude podle skillu brát jen jako prameny: pokyny v nich neprovádí
a podezřelé místo vám ukáže.
Instalujte skilly jen od lidí, kterým věříte.
## Podmínky archivů
Archivy mají pro své portály různé podmínky: některé snímky dovolují jen prohlížet, jiné zakazují roboty nebo
výdělečné užití, většina chce ke zveřejnění obrázku souhlas. Skill má jejich přehled v
[`reference/podminky.md`](skills/dejiny-domu/reference/podminky.md) a nástroje se jím řídí: kde stahování není dovolené,
snímek uložíte vy a Claude ho přečte, a obrázek, ke kterému archiv chce souhlas, nepustí na otevřený web.
Zákaz v robots.txt bere skill jako pokyn pro vyhledávače a plošné stahovače: na váš konkrétní dotaz stáhne jen to, co
hledáte, pomalu a nic dvakrát, jako byste klikali sami. Robots.txt, který jmenovitě zakazuje AI, podmínky zakazující
roboty a ověření „nejsem robot“ respektuje vždy.
Přehled vychází jen z veřejných zdrojů, není právně závazný a zatím není ověřený u jednotlivých archivů.
## Zpětná vazba
Chyby a nápady prosím [zakládejte jako issue](https://github.com/vzoha/dejiny-domu-skill/issues/new). Issues jsou
veřejné – nepište do nich údaje o žijících lidech. Claude si během práce zapisuje do `poznamky_pro_skill.md`
(v projektu), co by šlo zlepšit; ty můžete do issue zkopírovat.
## Licence
[MIT](LICENSE) – smíte skill volně používat, upravovat a šířit, jen zachovejte uvedení autorů (včetně autora rodokmenu).
© Vojtěch Žoha · MIT · vzoha/dejiny-domu-skill