skill
chytalnia
Скіли, методики й сирі матеріали архівного пошуку по українських селах. Напрацьовано для «Містка», викладено для всіх / Claude Code skills and methods for archival research on Ukrainian villages
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/mistok-wiki/chytalnia itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 17, 2026Читальня «Містка»
Як шукати, перевіряти й читати архівні джерела разом із мовною моделлю. Скіли для Claude Code, методики й матеріали, напрацьовані в роботі над сайтом «Місток».
Тут немає порад. Кожне правило або коштувало зіпсутого прогону, або виміряне числом, і число стоїть поруч із правилом.
Поставити
git clone https://github.com/mistok-wiki/chytalnia.git
ln -s "$PWD/chytalnia/skills/metryky" ~/.claude/skills/metryky
Символьне посилання зручніше за копію: git pull оновлює скіл на місці. Так само для решти скілів. Далі вони підхоплюються самі, коли ви просите прочитати скан або звірити текст із джерелами.
Скіли
| Про що | Найдорожче з того, що всередині | |
|---|---|---|
| metryky | Метричні книги й акти ЗАГС: де взяти справу, як прочитати аркуш, як записати прочитане | Одна сторінка = один агент. Агент, що прочитав тринадцять сторінок підряд, коштував 251 тисячу токенів, а три сусідні вмерли на ліміті, не записавши нічого |
| zvirka | Звірка написаного проти джерел: чи джерело каже саме це, чи виноска стоїть на потрібному реченні | Вікно навколо слів твердження завжди містить те, що шукали, тому «не знайшов» неможливо відрізнити від «джерело цього не каже» |
| presa | Стара періодика: ключі пошуку, вирізки замість шпальт, чотири тихі поломки OCR | З восьми написань назви села матеріал дала рівно одна форма. До того село пів року стояло як «у пресі порожньо» |
| rozvidka | Розвідка кількома агентами: ексклюзивні зони, ракурси, стелі викликів, бюджет | Ділити треба за джерелами, а не за темами: сім агентів по семи джерельних зонах не перетнулися жодного разу |
Матеріали
| Про що | |
|---|---|
| prohin-sela.md | Як робиться одне село, від запиту читача до відкритого PR: схема з усіма ролями, воротами й петлями. 30-60 агентів, 1000-2000 запитів до моделі й 4-12 сторінок на село; жоден агент не перевіряє сам себе і жоден не публікує |
| dozbir.md | Друга половина роботи: що робити з уже опублікованим. Шість місць, де лежить борг, 10-15 розвідників по каналах одночасно, позитивний контроль перед кожним «порожньо», чотири перевірки знахідки, суд і внесення по селах |
| kanaly.md | Як заходити в десять джерел для пошуку роду й села (LIBRARIA, FamilySearch, «Реабілітовані історією», ДАКО, ЦДІАК, Вікісховище, Книга Памʼяті, ОБД «Меморіал», Słownik geograficzny, бібліотечні каталоги) і де кожне збиває з пантелику. Прізвища великими літерами, через які пошук знаходить 44 людини з 278; чуже село під правильною назвою; титул справи, що бреше про її зміст |
| perevirka.md | Як перевіряти написане про своє село: три найчастіші помилки (цифра з розпізнаного тексту, речення, що каже більше за документ, посилання не біля того твердження), чому автор їх не бачить і чому потрібні двоє перевіряльників. На пʼяти сторінках сіл у середньому 22 помилки на сторінку, і дві третини з них знайшов лише один із двох |
| doslidzhennia/ | Журнал наших вимірів: що справді робить тексти точнішими, а що лише здається корисним. Одна перевірка моделлю бачить близько третини помилок сторінки, дві - половину, а три перевірки, звужені кожна до одного класу помилок, знаходять удвічі більше; довші цитати й дешевша модель автора дали вдвічі більше помилок. Вісім досліджень із числами, методом і межами |
| pastky.md | Двадцять три пастки архівного пошуку. Джерело, яке бреше про себе; пошук, який мовчить замість заперечувати; скан, на якому око бачить іншу неправду; перевірка, яка все пропустила |
| htr.md | Чому автоматичне читання рукопису поки що не працює, з арифметикою порогу. Варте читання, навіть якщо метрики вам байдужі |
Матеріали до пошуку
| Що всередині | |
|---|---|
| pokazhchyky/ | Де в справі чи томі лежить ваше село: ревізькі казки Київського повіту 1795-1834 років по пʼятьох справах ДАКО, зміст і покажчик «Історії міст і сіл» 1971 року по всій Київщині, люди макарівського розділу поіменно. У tsv, відкривається таблицею |
| dzherela/ | Бібліографія «Містка»: 640 джерел з архівними адресами й посиланнями, одним файлом |
| teksty/ | Розпізнаний текст двадцяти видань до 1917 року й довідника 1947 року, щоб шукати прізвище чи село, а не гортати скан |
Це росте з кожним селом: що і коли додалося, записано в ZMINY.md.
Хто це збирає. Насамперед штучний інтелект, Claude, у процесі роботи над «Містком»: він читає скани, виписує покажчики й звіряє написане з джерелами, а я перечитую й правлю за ним те, до чого дістаю. Обсяги такі, що помилка могла пройти повз мене: переплутана цифра сторінки, не та літера в назві села, зайвий рядок. Якщо ви таке помітили, відкрийте pull request або issue, я подивлюся. Найкорисніша правка та, де сказано, звідки ви знаєте: номер справи, сторінка скану, посилання.
Приклад
Один аркуш, прочитаний за цим скілом: ось фото, ось що вийшло. Замовлення було «прочитай метрику», а перше, що дав прохід, - це не метрична книга, а посімейний список ревізького типу.
Це не лише для Claude Code
Скіл це markdown, а не код. Порядок роботи, пастки й числа однаково читаються людиною й однаково кладуться в будь-який інший інструмент. Команди в текстах загальні (pdftotext, pdfimages, pdftoppm), ставити нічого не треба.
Ліцензія
MIT. Беріть, копіюйте, переробляйте під себе, вставляйте у свої скіли й проєкти, робіть що завгодно - питати дозволу не треба. Єдина умова MIT - зберігати текст ліцензії в копіях.
Єдине прохання, і воно не юридичне: згадуйте час від часу «Місток» :)
In English
Methods for finding, reading and fact-checking archival sources together with a language model: Claude Code skills and reference material built while researching Mistok, a Ukrainian local-history site.
Mistok currently covers 42 villages of the Makariv district (Kyiv oblast): 8,876 parish-register records, 116 biographies and 550 cited sources, with a footnote on every sentence. To see what a skill actually produces, here is one page read with metryky: the scan and the result.
There is no generic advice here. Every rule either cost a broken run or was measured, and the number sits next to the rule. For example, one agent that read thirteen register pages in a row burned 251k tokens while three neighbouring agents hit the limit without writing anything, hence the rule "one page, one agent".
- metryky - reading parish registers and civil registry acts from scans: where to find the file, how to read a page, how to record what was read.
- zvirka - checking a finished text against its sources: does the source say exactly this, and is the footnote on the right sentence.
- presa - searching digitized old newspapers: search keys across word forms and pre-reform spelling, clippings instead of full pages, silent OCR failures.
- rozvidka - splitting research across parallel agents: exclusive source zones, call ceilings, where the budget actually goes.
- doslidzhennia/ - a log of our measurements (in Ukrainian): what actually makes model-written local history more accurate. One model check finds about a third of a page's errors, two find about half, and three checks each narrowed to one error class find twice as many; longer quotes and a cheaper writing model doubled the errors. Eight studies with numbers, method and limits.
- pastky.md - twenty-three pitfalls of archival search.
- kanaly.md - how to search ten sources for a family or a village (newspapers, FamilySearch, repression volumes, civil registry acts, church records, Wikimedia Commons, war memorial databases, Słownik geograficzny, library catalogues) and where each one misleads.
- perevirka.md - how to check what is written about your village: the three most common errors, why the author cannot see them, and why two independent readers find different things.
- pokazhchyky/, dzherela/, teksty/ - finding aids (which file and page holds which village in the 1795-1834 revision lists and in the 1971 regional history volume), the full bibliography behind the site, and OCR text of pre-1917 books to search by surname or village. Grows with every village, see ZMINY.md.
Most of this material is gathered by Claude in the course of the work: it reads the scans, transcribes the finding aids and checks the text against its sources, and I review and correct what I can reach. At this volume a mistake can slip past me: a wrong page number, a wrong letter in a village name, a stray row. If you spot one, open a pull request or an issue and I will look at it; the most useful correction says where you know it from.
The skills are plain Markdown written in Ukrainian, so they work with any tool, not only Claude Code. Licensed under MIT.