instrument-data-to-allotrope

Convert instrument output files into Allotrope Simple Model JSON.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/sun2443/designer-skills --skill instrument-data-to-allotrope-sun2443
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instrument-data-to-allotrope
Source: https://github.com/sun2443/designer-skills/tree/main/bio-research/skills/instrument-data-to-allotrope
Command: npx skills add https://github.com/sun2443/designer-skills --skill instrument-data-to-allotrope-sun2443

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires allotropy, pandas, openpyxl, pdfplumber, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Scientists often receive instrument exports in inconsistent, vendor-specific formats that are hard to standardize for LIMS, data lakes, and downstream analytics. This Skill converts those files into Allotrope Simple Model (ASM) JSON (and optionally flattened 2D CSV and exportable Python parser code) so data can be reused reliably across teams and pipelines.

Core Features & Use Cases

  • Instrument file standardization: Convert common laboratory instrument outputs (PDF, CSV, Excel, TXT) into Allotrope Simple Model (ASM) JSON in a consistent schema for LIMS upload and long-term analysis.
  • Auto-detection with validation guardrails: Detect instrument type from file contents when possible, attempt native parsing via allotropy first, and validate output with a dedicated ASM validator to catch common mapping issues.
  • Multiple handoff formats: Produce full ASM JSON for semantic fidelity, flattened CSV for fast import and review, and exportable Python parsing code for data engineering production pipelines.
  • Correct handling of calculated values: Ensure calculated/derived results include required traceability back to their source measurements to support auditability and compliance workflows.

Quick Start

Use the instrument-data-to-allotrope skill to convert the attached file 'instrument_data.csv' into ASM JSON, then generate a flattened CSV for immediate import.

Frequently Asked Questions about instrument-data-to-allotrope

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert laboratory instrument data files to Allotrope Simple Model JSON?

To convert laboratory instrument data files to Allotrope Simple Model (ASM) JSON, the Skill uses native allotropy parsing with fallback mechanisms to standardize vendor-specific outputs like PDF, CSV, and Excel for consistent LIMS upload.

Can I generate a flattened CSV from instrument exports for LIMS upload?

Yes, you can generate a flattened 2D CSV from instrument exports for fast LIMS upload and review, while also retaining the full ASM JSON output to ensure semantic fidelity and long-term analytical reliability.

Does this approach support auto-detection of instrument type from file contents?

Yes, the approach supports auto-detection of instrument type from file contents, attempting native parsing via allotropy first and validating the output with a dedicated ASM validator to catch common mapping issues.

How are calculated values handled during instrument data standardization?

During instrument data standardization, calculated and derived results include required traceability back to their source measurements, ensuring auditability and supporting compliance workflows for downstream analytics.

What is the best way to create production-ready Python parser code from instrument data?

The best way to create production-ready Python parser code from instrument data is using this Skill to generate exportable parsing scripts, enabling data engineering teams to build automated pipelines for ASM conversion.

What happens if allotropy cannot natively parse an unsupported instrument format?

If allotropy cannot natively parse an unsupported instrument format, the Skill applies fallback parsing mechanisms to process the raw data and still attempts to output standardized ASM JSON with validation guidance.