genome-computer

Readmygenome — Development skill for Claude Code

Development community

Claude skill for reading .genome bundles correctly, with provenance.

How to install Readmygenome

This entry records only its repository, not the path inside it, so there is no exact command to give. Open genome-computer/readmygenome and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Readmygenome does

Claude skill for reading .genome bundles correctly, with provenance.

Alternatives in Development

  • Validate Plan — You are tasked with validating that an implementation plan was correctly executed, verifying all success crite 10k ★
  • Ccundo — Integrates seamlessly with Claude Code to provide granular undo functionality by reading directly from Claude 1.4k ★
  • Maestro Learn — User-invoked learning toolkit — guided reading, investigation, pattern extraction, or second opinions 530 ★

README

readmygenome

*A Claude skill that lets AI read `.genome` bundles correctly.*

Drop `readmygenome.md` into Claude's skills folder. Upload a `.genome/1.0` bundle. Ask anything.

you: What actionable findings do I have?
claude: [validates the bundle, runs the canonical query, returns findings
         with gene, HGVSp, ClinVar significance, and review stars — citing
         the exact is_actionable rule from the bundle's manifest]

What this is

`.genome` is an open specification for a consumer genome file designed to be read by an AI ([github.com/genome-computer/genome-spec](https://github.com/genome-computer/genome-spec)). This skill is the operational integration that lets Claude reason over a `.genome` bundle without re-introducing the failure modes the bundle was designed to prevent.

The skill is deliberately narrow. It answers factual questions about a bundle's contents, with provenance, against a versioned schema. It does not provide medical advice, drug recommendations, or diagnostic conclusions.

Install

**One-line install** (from the repository root):

cp readmygenome.md ~/.claude/skills/readmygenome/SKILL.md
cp -r scripts reference requirements.txt ~/.claude/skills/readmygenome/

Claude's skill loader looks for a file named `SKILL.md` inside each skill directory — the file in this repo is named `readmygenome.md` because that is the product name you'll see everywhere else. The rename is a one-line copy.

Python dependencies for the helper scripts:

pip install -r requirements.txt

That installs `duckdb`, `pyarrow`, and `jsonschema`.

Verify the install

Open a Claude conversation and type:

*What skills do you have loaded?*

You should see `readmygenome` in the list. If not, check that `~/.claude/skills/readmygenome/SKILL.md` exists and that its YAML frontmatter contains `name: readmygenome`.

Using with other agent systems

The heart of the skill is `readmygenome.md` — a single markdown file with YAML fron