record-extraction

Extracts GPS-conformant assertions and evidence classifications from genealogical records.

3|3|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill record-extraction-pioneeraiacademy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: record-extraction
Source: https://github.com/PioneerAIAcademy/cowork-genealogy/tree/main/packages/engine/plugin/skills/record-extraction
Command: npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill record-extraction-pioneeraiacademy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Genealogical research requires converting raw records (census sheets, certificates, PDFs, images) into structured, evidence-classified assertions that meet the Genealogical Proof Standard. Doing this manually is error-prone, and misclassifying sources or informants corrupts every downstream conclusion. ## Core Features & Use Cases - Record triage and delegation: Acquires records from search results, ARKs, uploaded PDFs, or images, logs them to the research audit trail, and delegates each to a record-extractor agent for atomic assertion extraction. - Three-layer evidence classification: Applies source (original/derivative/authored), information (primary/secondary/undetermined), and informant-bias analysis per fact, following BCG standards. - Calendar and transcription safeguards: Routes pre-Gregorian dates through convert-dates and flags suspect index transcriptions for original-image confirmation. - Use Case: After a FamilySearch census search returns 12 results, the skill logs the search, delegates each record for extraction, and persists sources and assertions into research.json without duplicating existing entries. ## Quick Start Extract assertions from the 1880 census record for the Schuylkill County household and classify the evidence for each fact.

Frequently Asked Questions about record-extraction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract assertions from a genealogical record?▼

Provide the record as a search result, ARK, PDF, or image and ask to extract assertions. The skill triages the input, logs it to the research log, and delegates extraction to a record-extractor agent that writes sources and assertions with evidence classifications.

What is the difference between primary and secondary information in genealogy?▼

Primary information comes from an informant who witnessed or participated in the event; secondary information is reported secondhand. Each fact in a record is classified separately based on who provided that specific piece of information.

Can this skill read FamilySearch record images directly?▼

No, image reading is delegated to a separate image-reader subagent that OCRs the scan and returns a transcription. The raw image never enters the main context, and unreadable images trigger a pivot to indexed records instead.

How are Old Style dates handled during record extraction?▼

Dates that may predate a jurisdiction's Gregorian calendar adoption are passed through the convert-dates tool before delegation. The converted reading is carried as a flag so the extractor records the date with the proper qualification.

When should I not use record extraction?▼

Do not use it to search for records (use search-records or search-external-sites) or to format citations (use the citation skill). It only processes records already found or provided by the user.