OMERO Integration (Microscopy Data)
Safely inspect, export, and plan microscopy data workflows on an OMERO.server using omero-py, BlitzGateway, and the CLI.
What it does
Connects to OMERO.server, the bioimage data management platform, to traverse Project/Dataset/Image hierarchies and export metadata — tags, map annotations, ROIs, and OMERO.tables — as tightly scoped JSON. The skill explains when to reach for BlitzGateway (Python), the OMERO CLI, or the officially supported OMERO.web api/webgateway endpoints, and walks through a reproducible client setup (OMERO.py 5.22.1 with IcePy 3.6.5 on Python 3.12).
Its strongest feature is the operating contract: credentials are read only from declared OMERO_* variables, never echoed into arguments, logs, or output; bundled remote helpers are dry-run by default and require --execute; every write (annotation creation, import, rendering-default save, deletion) needs an explicitly reviewed target ID. Connections, table handles, and raw stores must be closed in finally blocks.
Who it's for
- Researchers who store microscopy images in OMERO and need recurring inventories or metadata dumps
- Core imaging facility data managers planning imports and OME-TIFF exports
- Teams that must strictly bound scope so unpublished images never leave the server
Examples
- "List 25 images under Project 42 ordered by ID" →
inventory.pyproduces a paged, read-only JSON inventory - "Export tags and ROIs for images 1011 and 1012, no pixel bytes" →
export_image_metadata.pyapplies per-category limits and redaction defaults - "Show me the import plan for this local folder first" →
plan_transfer.pyruns entirely offline and never touches OMERO
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/omero-integration folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/omero-integration/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/omero-integration ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Clone the repository:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Copy the skill into place:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/omero-integration ~/.claude/skills/ - Create a Python 3.12 environment:
uv venv --python 3.12 .venv && source .venv/bin/activate - Download the
zeroc_ice-3.6.5wheel matching your OS, architecture, and interpreter from the official OMERO-linked matrix and install it (do not substitute Ice 3.7). - Install the client:
uv pip install "omero-py==5.22.1" - Export connection variables:
OMERO_HOST,OMERO_PORT=4064,OMERO_USER, andOMERO_SECURE=true. Supply the password or session key through a secret manager so it never lands in shell history. - Restart Claude Code, then dry-run
python -B ~/.claude/skills/omero-integration/scripts/validate_config.py --helpbefore doing any real remote work.