dejiny-domu — плагин для Claude Code: история дома
Плагин dejiny-domu для Claude Code помогает исследовать историю дома и деревни по чешским архивам. Он собирает сведения в сайт с временной шкалой, источниками и фрагментами старых записей.
MIT ★ 78 обновлён 2026-11-15
/plugin marketplace add vzoha/dejiny-domu-skill
/plugin install dejiny-domu@dejiny-domu-skillЧто делает dejiny-domu
Плагин ведёт исследование от известных владельцу сведений о доме до архивных источников и готового сайта. Он ищет данные переписей, метрических книг, кадастров, старых карт и газет, а также помогает читать записи, делать фрагменты снимков, расшифровывать и переводить их. В центре исследования — номер дома и жившие там люди, а не родословная одного человека.
В проекте есть инструкции, справочные материалы, Python-инструменты и шаблон сайта на Astro. Каждый факт на сайте связан с источником; сомнительные места отмечаются, но ИИ может ошибиться при чтении имени или соотнесении записи с домом. Для работы нужны Claude Code с платной подпиской Claude, Python 3, Node.js, ImageMagick и git. Netlify и ключ Europeana нужны только для публикации сайта и поиска старых изображений соответственно.
Какие задачи решает
- проследить владельцев и жильцов дома по архивам
- сопоставить старые номера дома с архивными записями
- расшифровать и перевести фрагменты исторических документов
- собрать сайт с историей дома и ссылками на источники
Примеры запросов агенту
- Найди историю дома с номером 12 в Horní Lhotě.
- Собери временную шкалу владельцев и жильцов нашего дома по архивным записям.
- Подготовь сайт с историей дома и ссылками на источники.
Как установить dejiny-domu
Через маркетплейс плагинов
/plugin marketplace add vzoha/dejiny-domu-skill/plugin install dejiny-domu@dejiny-domu-skillПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о dejiny-domu
Как установить dejiny-domu в Claude Code?
Выполните команды по порядку: /plugin marketplace add vzoha/dejiny-domu-skill, затем /plugin install dejiny-domu@dejiny-domu-skill. После установки перезапустите Claude Code.
Что делает dejiny-domu?
Плагин помогает исследовать историю дома и деревни по чешским архивам, читает и расшифровывает записи и собирает сайт с временной шкалой и источниками.
Что нужно для работы dejiny-domu?
Нужны Claude Code с платной подпиской Claude, Python 3, Node.js, ImageMagick и git. Netlify для публикации сайта и ключ Europeana для поиска старых изображений опциональны.
Исходный текст
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