freezer-sample-locator

What This Skill Does

The freezer-sample-locator is an essential tool for biobanking and laboratory management, designed to digitize the physical organization of deep-freeze (-80°C) storage. It acts as a hierarchical database agent, tracking the exact location of biological samples across freezers, levels, racks, and box grids. By replacing manual, error-prone paper logs with structured JSON-based storage, it ensures that researchers can pinpoint any sample in seconds. The skill features robust conflict detection to prevent two samples from occupying the same grid position, and it supports bulk export for laboratory auditing and inventory reporting. It is designed for high-performance retrieval, maintaining sub-second query speeds even with thousands of entries.

Installation

To integrate this skill into your environment, execute the following command in your terminal or via the OpenClaw command interface: clawhub install openclaw/skills/skills/aipoch-ai/freezer-sample-locator Ensure your local environment has write permissions in the directory where the data file will be stored.

Use Cases

• Inventory Management: Quickly audit the contents of a specific freezer during quarterly lab cleanouts.
• Search and Recovery: Locate a specific patient sample by project code or name without opening freezer doors unnecessarily, saving energy and preserving sample integrity.
• Compliance & Reporting: Generate CSV export reports of all stored samples for Institutional Biosafety Committee (IBC) or quality control audits.
• Project Tracking: Manage multi-year research projects by segregating samples by project identifiers while maintaining a unified search index.

Example Prompts

• "OpenClaw, find all samples associated with project 'Oncology-A' located in freezer F01 and export them to a CSV file."
• "Record a new sample in freezer F02, level 3, rack B, box 05, position C4 for the 'CRISPR-Study' project."
• "Show me an inventory list of all samples currently in freezer F03 to check for available space."

Tips & Limitations

• Data Integrity: Always use the 'list' command to verify free space before adding new samples to avoid accidental overwrites.
• Backup: Since data is stored in JSON format, consider setting up a periodic backup task for your local inventory directory to prevent data loss.
• Performance: While the system is optimized for speed, maintain consistency in naming conventions (e.g., always use 'F01' instead of 'Freezer 1') to ensure accurate fuzzy searching.
• Limitations: This skill operates on local file systems; ensure regular synchronization if the repository is shared across multiple lab workstations.