Freezer Sample Locator | Skills Pool
Freezer Sample Locator Track and retrieve sample locations in -80°C freezers with hierarchical storage organization.
Trigger conditions:
- User needs to record sample storage positions (freezer ID, level, rack, box, grid position)
- User requests to search samples by name, project, date, or location
- User requires sample inventory management and export functionality
Input: Sample metadata (name, project, quantity) and storage coordinates
Output: Structured sample location records with search and export capabilities
Success criteria:
- Accurate position recording without conflicts
- Fast search and retrieval (<1 second for 1000+ samples)
- Data integrity maintained across operations
- Export in multiple formats (JSON, CSV)
Risk level: MEDIUM (Script execution with file system access)
Technical difficulty: INTERMEDIATE
Version: v1.0
Owner: 研发部
Last updated: 2026-02-06
openclaw 4,189 stars Mar 25, 2026
Occupation Categories Lab Tools Purpose : Systematically manage and retrieve sample locations in -80°C freezers using hierarchical storage organization.
Classification : Tool/Script型 (本地脚本执行)
🎯 Core Functions
Primary Operations
Record : Store sample locations with hierarchical coordinates (freezer → level → rack → box → position)Retrieve : Search samples by name, project, freezer, date, or unique IDManage : Update sample metadata, delete records, maintain inventoryExport : Generate reports in CSV/JSON formats with filtering options
Data Integrity Features
Conflict Detection : Prevent duplicate position assignmentsValidation : Enforce proper location encoding rulesAudit Trail : Track creation and modification timestampsBackup : JSON-based storage with automatic file creation
Quick Install
Freezer Sample Locator npx skillvault add openclaw/openclaw-skills-skills-aipoch-ai-freezer-sample-locator-skill-md
Author openclaw
stars 4,189
Updated Mar 25, 2026
Occupation
Data Structure Sample location information is stored in JSON files:
{
"samples": [
{
"id": "uuid",
"name": "Sample Name",
"project": "Project Name",
"freezer": "F01",
"level": 1,
"rack": "A",
"box": "01",
"position": "A1",
"quantity": 1,
"date_stored": "2024-01-15",
"notes": "Notes",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}
]
}
Parameters
Global Parameters Parameter Type Default Required Description commandstring - Yes Command to execute (add, search, list, update, delete, export, stats) --configstring - No Path to configuration file
Add Command Parameter Type Default Required Description --namestring - Yes Sample name --projectstring - Yes Project identifier --freezerstring - Yes Freezer ID (e.g., F01) --levelint - Yes Shelf level number --rackstring - Yes Rack identifier --boxstring - Yes Box number --positionstring - Yes Position within box (e.g., A1) --quantityint 1 No Sample quantity --notesstring - No Additional notes
Search Command Parameter Type Default Required Description --namestring - No Search by sample name (fuzzy) --projectstring - No Search by project (exact) --freezerstring - No Search by freezer ID --idstring - No Search by sample UUID
List Command Parameter Type Default Required Description --freezerstring - No Filter by freezer ID
Update Command Parameter Type Default Required Description --idstring - Yes Sample UUID to update --positionstring - No New position --quantityint - No New quantity --notesstring - No New notes
Delete Command Parameter Type Default Required Description --idstring - Yes Sample UUID to delete
Export Command Parameter Type Default Required Description --output, -ostring - Yes Output file path --freezerstring - No Filter by freezer ID
Stats Command No additional parameters required.
Usage
🚀 Usage Guide
Command Line Interface
Sample Management # Add new sample
python scripts/main.py add \
--name "Sample-001" \
--project "Project-A" \
--freezer "F01" \
--level 1 \
--rack "A" \
--box "01" \
--position "A1" \
--quantity 2 \
--notes "Primary culture"
# Search operations
python scripts/main.py search --name "Sample-001" # Name search (fuzzy)
python scripts/main.py search --project "Project-A" # Project search (exact)
python scripts/main.py search --freezer "F01" # Freezer search
python scripts/main.py search --id "uuid-string" # ID search (exact)
# List with optional filtering
python scripts/main.py list # All samples
python scripts/main.py list --freezer "F01" # Specific freezer
# Update sample information
python scripts/main.py update --id "uuid" --position "B2" --quantity 1
# Delete sample record
python scripts/main.py delete --id "uuid"
# Export functionality
python scripts/main.py export --output samples.csv --freezer "F01"
# Statistics
python scripts/main.py stats
Python API Usage from scripts.main import FreezerSampleLocator
# Initialize locator
locator = FreezerSampleLocator()
# Add sample with validation
sample = locator.add_sample(
name="Sample-001",
project="Project-A",
freezer="F01",
level=1,
rack="A",
box="01",
position="A1",
quantity=2,
notes="Primary culture"
)
# Search with multiple criteria
results = locator.search_samples(
name="Sample-001",
project="Project-A"
)
# Get formatted location
location = locator.get_sample_location(sample_id)
print(location["location_str"]) # "F01 > L1 > RA > B01 > A1"
# Export data
locator.export_csv("inventory.csv", freezer="F01")
🧪 Evaluation & Testing
Success Criteria
Functional Accuracy : 100% correct position recording and retrievalPerformance : <1 second response time for 1000+ sample databaseData Integrity : Zero corruption in concurrent operationsUser Experience : Clear error messages and intuitive commands
Test Suite # Core functionality tests
def test_add_sample():
"""Test sample addition with validation"""
def test_search_operations():
"""Test search by name, project, freezer"""
def test_conflict_prevention():
"""Test duplicate position detection"""
def test_export_functionality():
"""Test CSV/JSON export formats"""
def test_data_integrity():
"""Test concurrent access safety"""
Validation Checklist
📊 Monitoring & Maintenance
Usage Metrics
Operation Volume : Track add/search/update/delete frequenciesDatabase Size : Monitor sample count growthPerformance Metrics : Response time trendsError Rates : Failed operation frequency
Maintenance Tasks
Data Backup : Regular JSON file backupsPerformance Optimization : Index rebuilding for large datasetsValidation Updates : Location encoding rule changesSecurity Review : Access pattern analysis
Health Checks # Verify database integrity
python scripts/main.py stats
# Test search performance
python scripts/main.py search --name "test"
# Export validation
python scripts/main.py export --output test.csv
📋 Location Encoding Standards
Hierarchical Coordinate System Component Format Range Description Freezer ID F01, F02, F03... F01-F99 Physical freezer unit Level 1-10 1-10 Vertical level (top to bottom) Rack A-Z A-Z Horizontal rack position Box 01-99 01-99 Box number within rack Position A1-H12 A1-H12 Grid position (96-well standard)
Validation Rules
Uniqueness : Each position can contain only one sampleFormat Compliance : Strict pattern matching enforcedRange Checking : All components validated against allowed rangesConflict Prevention : Real-time duplicate detection
{Freezer} > L{Level} > R{Rack} > B{Box} > {Position}
Example: F01 > L1 > RA > B01 > A1
🔒 Security & Compliance
Risk Assessment
File System Access : ✅ Controlled to skill directory onlyScript Execution : ✅ Sandboxed Python environmentData Privacy : ✅ No external network calls or data transmissionInput Validation : ✅ Comprehensive parameter checking
Security Controls
Path Constraints : Limited to data/ subdirectory within skill folderInput Sanitization : Validates all coordinates and metadataError Handling : Safe exception handling without information leakageAccess Control : No privileged operations or system calls
🔄 Lifecycle Management
Version History Version Date Changes Author v1.0 2026-02-06 Initial release with core functionality 研发部
Deployment Status
Environment : Production readyTest Coverage : Manual validation completedSecurity Review : ✅ Passed (MEDIUM risk accepted)Performance : ✅ Meets requirements (<1s response)
Monitoring Plan
Daily : Usage statistics and error logsWeekly : Performance metrics and database sizeMonthly : Security audit and backup verificationQuarterly : Feature review and optimization assessment
Deprecation Policy
Notice Period : 3 months for major changesMigration Support : Data export tools providedBackward Compatibility : Maintained for minor versions
Technical Support
Owner : 研发部Escalation : Contact skill repository maintainersDocumentation : This file + inline code comments
Issue Reporting
Bug Reports : Include error messages and reproduction stepsFeature Requests : Provide use case and requirementsSecurity Issues : Report immediately to security team
📦 Dependencies & Prerequisites
Runtime Requirements
Python : 3.8+ (standard library only)No third-party dependencies : Reduces supply chain risk
File Structure freezer-sample-locator/
├── SKILL.md # This file
├── scripts/
│ └── main.py # Core implementation
└── data/
└── samples.json # Sample database (auto-created)
Installation & Setup # No additional installation required - uses Python standard library
# Data directory created automatically on first run
Skill Classification : Tool/Script型 (MEDIUM Risk)Compliance Status : ✅ Approved for production useNext Review : 2026-05-06
Risk Assessment Risk Indicator Assessment Level Code Execution Python/R scripts executed locally Medium Network Access No external API calls Low File System Access Read input files, write output files Medium Instruction Tampering Standard prompt guidelines Low Data Exposure Output files saved to workspace Low
Security Checklist
Prerequisites No additional Python packages required.
Evaluation Criteria
Success Metrics
Test Cases
Basic Functionality : Standard input → Expected outputEdge Case : Invalid input → Graceful error handlingPerformance : Large dataset → Acceptable processing time
Lifecycle Status
Current Stage : DraftNext Review Date : 2026-03-06Known Issues : NonePlanned Improvements :
Performance optimization
Additional feature support
Primary Operations