{
  "markdown": "# gedcom-skills\n\nA Claude Code plugin that ships skills for working with [GEDCOM](https://www.gedcom.org/) genealogy files. The skills are thin SKILL.md wrappers around console scripts published by two sibling Python packages: [**gedcom-lite**](https://github.com/vaelen/gedcom-lite) — the fidelity-preserving parser/writer that powers `read-gedcom`, `search-gedcom`, and `update-gedcom` — and [**gedcom-reports**](https://github.com/vaelen/gedcom-reports), which provides the `gedcom-ancestor-report` script behind the `ancestor-report` skill.\n\n## Skills\n\n| Skill | What it does | Sample prompts |\n| --- | --- | --- |\n| **read-gedcom** | Summarize a file, list records, show one record by xref. | \"What's in `tree.ged`?\", \"list everyone in this GEDCOM\", \"show me record @I42@\" |\n| **search-gedcom** | Query by tag/value/path or by person/date/place/relationship (ancestors, descendants, parents, children). | \"find people named Smith\", \"who was born between 1900 and 1910\", \"ancestors of @I1@\" |\n| **update-gedcom** | Set, add, remove with round-trip fidelity; safe-by-default writes. | \"change @I1@'s name to Jane Doe\", \"add a NOTE to @I7@\", \"delete record @I9@\" |\n| **ancestor-report** | Generate a markdown ancestor report organized by generation (Ahnentafel-numbered), with categorized immigrant tables and a colonial-ancestors section. | \"report all my ancestors back 7 generations\", \"make a markdown report of @I1@'s ancestry\", \"list immigrants in my tree by region\", \"build a colonial ancestors report\" |\n\nFor the operational details of each, read the skill's `SKILL.md`.\n\n## Install\n\nInside Claude Code, add the marketplace and install the plugin:\n\n```text\n/plugin marketplace add vaelen/gedcom-skills\n/plugin install gedcom-skills@gedcom-skills\n```\n\n`/plugin marketplace add` accepts a `owner/repo` shorthand for GitHub or a full URL to any git host. After installation all four skills (`read-gedcom`, `search-gedcom`, `update-gedcom`, `ancestor-report`) are available in every session.\n\nThe skills shell out to `gedcom-lite` and `gedcom-reports` via `uvx`, so [`uv`](https://docs.astral.sh/uv/) must be on your `PATH`. No separate `pip install` is needed — `uvx` fetches each package on first use.\n\n## Versions in scope\n\n| Version | Year | Why we support it |\n| --- | --- | --- |\n| GEDCOM 5.5.1 | 1999 | Most-deployed legacy format. The de-facto interchange format used by virtually every genealogy app shipped before 2022. |\n| GEDCOM 5.5.5 | 2019 | Cleanup release of the 5.5 line. UTF-8 only; not widely adopted but useful as a reference. |\n| FamilySearch GEDCOM 7.0+ | 2021– | Current, actively maintained. UTF-8 only; defines a real extension mechanism and GEDZIP packaging. |\n\nGEDCOM 7 is a breaking change from 5.5.x. `gedcom-lite` reads any of the three; on write it never silently promotes a file to a different version.\n\n## Layout\n\n```\n.\n├── README.md              # this file\n├── CLAUDE.md              # working agreements for Claude Code in this repo\n├── .claude-plugin/\n│   └── plugin.json        # plugin manifest\n├── skills/\n│   ├── read-gedcom/SKILL.md\n│   ├── search-gedcom/SKILL.md\n│   ├── update-gedcom/SKILL.md\n│   └── ancestor-report/SKILL.md\n├── docs/                  # GEDCOM-domain reference (linked from each SKILL.md)\n└── examples/              # small demo set; the full fixture suite lives in gedcom-lite\n```\n\nThere is no Python code in this repo. The parser, writer, ANSEL codec, CLI tools, and full test suite live in [`gedcom-lite`](https://github.com/vaelen/gedcom-lite); the report generator lives in [`gedcom-reports`](https://github.com/vaelen/gedcom-reports).\n\n## How invocations work\n\nEvery skill uses the same shape: `uvx --from <package> <command>`. `uvx` (which ships with [`uv`](https://docs.astral.sh/uv/)) caches an ephemeral environment with the package installed, so no prior `pip install` is required:\n\n```bash\nuvx --from gedcom-lite    gedcom-read            tree.ged\nuvx --from gedcom-lite    gedcom-search          tree.ged --person Smith\nuvx --from gedcom-lite    gedcom-update          tree.ged -o new.ged set-payload @I1@ NAME \"Jane /Doe/\"\nuvx --from gedcom-reports gedcom-ancestor-report tree.ged --root @I1@ --depth 7 --output report.md\n```\n\nTo run unreleased changes from git instead of the PyPI release:\n\n```bash\nuvx --from \"git+https://github.com/vaelen/gedcom-lite\"    gedcom-read            tree.ged\nuvx --from \"git+https://github.com/vaelen/gedcom-reports\" gedcom-ancestor-report tree.ged --root @I1@\n```\n\nIf the packages are installed system-wide (`pip install gedcom-lite gedcom-reports` or `uv tool install ...`), invoke the commands directly without `uvx`.\n\n## Example files\n\n`examples/` ships a small demo set so the skills can be exercised without checking out the library:\n\n- `examples/gedcom70/minimal70.ged` — smallest valid GEDCOM 7.0 file\n- `examples/gedcom70/maximal70.ged` — broad GEDCOM 7.0 coverage (every standard tag in many positions)\n- `examples/gedcom555/MINIMAL555.GED` — smallest valid GEDCOM 5.5.5 file\n- `examples/gedcom555/555SAMPLE.GED` — canonical GEDCOM 5.5.5 sample\n\nFor the full official test suite (UTF-16, ANSEL, extensions, escapes, voidptrs, GDZ archives, …) see [`gedcom-lite/examples/`](https://github.com/vaelen/gedcom-lite/tree/main/examples).\n\n## References\n\n- [gedcom-lite](https://github.com/vaelen/gedcom-lite) — the parser/CLI package behind `read-gedcom`, `search-gedcom`, `update-gedcom`\n- [gedcom-reports](https://github.com/vaelen/gedcom-reports) — the report generator behind `ancestor-report`\n- [GEDCOM 5.5.5 specification](https://www.gedcom.org/) — gedcom.org\n- [FamilySearch GEDCOM 7 specification](https://gedcom.io/specifications/FamilySearchGEDCOMv7.html) — gedcom.io\n- [FamilySearch GEDCOM Compatibility Guide](https://gedcom.io/compatibility/)\n\n## License\n\nMIT — Copyright © 2026 Andrew C. Young (andrew@vaelen.org). See [LICENSE](LICENSE) for the full text. The underlying [`gedcom-lite`](https://github.com/vaelen/gedcom-lite/blob/main/LICENSE) and [`gedcom-reports`](https://github.com/vaelen/gedcom-reports) packages are distributed under the same terms.\n",
  "bytes": 6088,
  "sha": "20bf2c3c47488d0611c92e44a41ebef84ed98ffc798e30f0f11800a92cce963d",
  "repo_slug": "vaelen/gedcom-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_vaelen_gedcom_skills_gedcom_genealogy_sk_4cc48a0b/readme"
}