audit-domain

Audit genealogical domain models for GEDCOM compliance and produce scorecards with issue-ready tickets.

4|1|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/cacack/my-family --skill audit-domain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-domain
Source: https://github.com/cacack/my-family/tree/main/.claude/skills/audit-domain
Command: npx skills add https://github.com/cacack/my-family --skill audit-domain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The audit-domain skill helps projects ensure their genealogical domain model, date/place handling, citation model, and GEDCOM import/export are standards-compliant and lossless, reducing data integrity and interoperability risks.

Core Features & Use Cases

  • Domain Model Review: Inspect person and relationship types for correct name structures, gender handling, UUID identity, and validation methods.
  • Date and Place Analysis: Verify support for exact, approximate, range, partial, and calendar-aware dates and assess place/citation linkage.
  • GEDCOM Fidelity Evaluation: Check import/export codepaths for lossless round-trip handling, non-standard tag resilience, Unicode support, and export validity.
  • Deliverables: Produces a scored scorecard, prioritized findings with code-and-doc evidence, GitHub-ready issue templates, and manual verification checkpoints.
  • Use Case: Use when preparing a release, migrating data stores, or validating third-party GEDCOM imports to prevent data loss or modeling errors.

Quick Start

Run a domain audit that inspects internal/domain and internal/gedcom code plus docs to produce a scorecard, prioritized findings with evidence, and issue-ready tickets.

Frequently Asked Questions about audit-domain

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

FAQPage Schema
How do I audit a genealogy domain model for GEDCOM fidelity?

Auditing a genealogy domain model involves inspecting internal domain and GEDCOM codepaths to verify person, relationship, date, place, and citation models for standards compliance, producing a scored scorecard and issue-ready GitHub tickets.

What does lossless GEDCOM round-trip handling mean for genealogy data?

Lossless GEDCOM round-trip handling ensures that importing and exporting data preserves all person, relationship, date, and place attributes without degradation. Evaluating this checks import/export codepaths for non-standard tag resilience, Unicode support, and export validity.

How do I check if my genealogy date and place models support calendar-aware formats?

Checking date and place models requires verifying support for exact, approximate, range, and partial dates alongside calendar-aware logic. An audit assesses this by inspecting internal domain code and documentation to ensure proper place and citation linkage.

When should I run a GEDCOM standards compliance audit on my repository?

You should run a GEDCOM standards compliance audit when preparing a release, migrating data stores, or validating third-party GEDCOM imports. This prevents data loss and modeling errors by verifying your domain model against documented invariants and integration matrices.

Can I generate GitHub issue tickets from a genealogy domain model code review?

Yes, auditing a genealogy domain model produces issue-ready GitHub tickets as a deliverable. The audit inspects internal domain and GEDCOM code to create prioritized findings with code-and-doc evidence references and manual verification checkpoints.