🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί EC Sample Tracker
πŸ¦€ ClawHub

EC Sample Tracker

by @xrayxiaoruiyang-pixel

Track and manage electrochemistry samples from synthesis to characterization with data linking, event logging, search, export, and dashboard visualization.

Versionv1.0.0
Downloads576
#clawhub
TERMINAL
clawhub install ec-sample-tracker

πŸ“– About This Skill

ec-sample-tracker-1.0.0 β€” Sample Tracker for Electrochemistry Labs

Track physical samples from synthesis through every characterization result. Connect samples to their storage locations, synthesis records, and all associated data files (LSV/CV/EIS/XRD/SEM/TEM etc.).

Usage

ec-sample-tracker  [options]

Commands

  • add β€” Register a new sample
  • list β€” List samples with filters
  • status β€” Show sample status overview
  • link β€” Attach data files or notes to a sample
  • search β€” Search samples by name, tag, synthesis date, or property
  • log β€” Log an experimental event (measurement, storage move, aging)
  • export β€” Export sample records as CSV/JSON/Markdown
  • import β€” Bulk import from CSV
  • dashboard β€” Visual dashboard of sample inventory and status

    • Sample Record Schema

    sample_id       β€” Auto-generated (e.g. CAT-2026-0042)
name            β€” Sample name/label
synthesis_date  β€” YYYY-MM-DD
synthesis_method β€” hydrothermal / electrodeposition / impregnation / sol-gel / thermal decomposition / commercial
precursors      β€” Comma-separated list
substrate       β€” GC / Ti foil / Ni foam / FTO / ITO / Carbon paper / None
catalyst_load   β€” mg/cmΒ² (if applicable)
target_reaction β€” OER / HER / ORR / CO2RR / other
tags            β€” Comma-separated tags
storage_location β€” fridge-4 / rack-A2 / desiccator-2 / given-out
owner           β€” Name
notes           β€” Free-text notes
status          β€” active / degraded / given-out / disposed / lost

    Link Types

  • ec β€” LSV/CV/EIS/CP/CA files
  • xrd β€” XRD data
  • sem / tem β€” Electron microscopy
  • raman β€” Raman spectra
  • xps β€” XPS data
  • photo β€” Sample photos
  • note β€” Free-text notes
  • protocol β€” Synthesis protocol PDF

    • Configuration (config.yaml)

    lab_name: "Electrochemistry Lab"
id_prefix: "CAT"
next_id: 1
storage_locations:
  - fridge-4
  - rack-A2
  - rack-B1
  - desiccator-2
  - drawer-3
  - given-out
default_owner: "xray"
db_file: "samples.db"
data_root: "/home/xray/data"

    Dashboard

    Generates a 4-panel PNG dashboard: 1. Sample count by status (pie chart) 2. Samples by reaction type (bar chart) 3. Storage location distribution (bar chart) 4. Recent activity log (text table)

    Examples

    # Add a new sample
ec-sample-tracker add --name "NiFe-LDH/CF-2026-042" \
  --method hydrothermal --precursors "Ni(NO3)2,Fe(NO3)3" \
  --substrate "Ni foam" --load 2.1 --reaction OER \
  --tags "NiFe-LDH,hydrothermal,batch-42" \
  --storage fridge-4 --notes "Synthesized for OER stability test"
    Link characterization data
    
ec-sample-tracker link CAT-2026-0042 --type ec --file ~/data/oer_lsv_042.csv
ec-sample-tracker link CAT-2026-0042 --type xrd --file ~/data/xrd_042.asc
    Search samples
    
ec-sample-tracker search --tag NiFe-LDH --reaction OER
ec-sample-tracker search --synth-date-after 2026-03-01
    List all active samples
    
ec-sample-tracker list --status active
    Log an experimental event
    
ec-sample-tracker log CAT-2026-0042 --event "LSV cycling started" \
  --note "100 cycles in 1M KOH, 10 mA/cmΒ²"
    Export all samples
    
ec-sample-tracker export --format markdown --output samples-report.md
    Generate dashboard
    
ec-sample-tracker dashboard --output sample-dashboard.png

    Database

    Uses SQLite (samples.db) with tables:

  • samples β€” Core sample records
  • links β€” File/note attachments
  • events β€” Timestamped experimental events
  • measurements β€” Quantitative measurement results (overpotential, Tafel, ECSA, etc.)

    • Output Files

  • samples.db β€” SQLite database
  • samples.csv β€” Full export
  • sample-dashboard.png β€” Visual dashboard (300 DPI)
  • sample-YYYY-MM-DD.md β€” Markdown report

    • Use Cases

  • Track which samples have LSV/CV/EIS data collected
  • Find all samples from a specific synthesis batch or precursor combination
  • Log degradation events and link to characterization
  • Generate sample inventory for lab audits or paper supplementary
  • Connect synthesis records to performance metrics

    • ⚑ When to Use

    TriggerAction
    - Find all samples from a specific synthesis batch or precursor combination
    - Log degradation events and link to characterization
    - Generate sample inventory for lab audits or paper supplementary
    - Connect synthesis records to performance metrics

    πŸ’‘ Examples

    # Add a new sample
ec-sample-tracker add --name "NiFe-LDH/CF-2026-042" \
  --method hydrothermal --precursors "Ni(NO3)2,Fe(NO3)3" \
  --substrate "Ni foam" --load 2.1 --reaction OER \
  --tags "NiFe-LDH,hydrothermal,batch-42" \
  --storage fridge-4 --notes "Synthesized for OER stability test"
    Link characterization data
    
ec-sample-tracker link CAT-2026-0042 --type ec --file ~/data/oer_lsv_042.csv
ec-sample-tracker link CAT-2026-0042 --type xrd --file ~/data/xrd_042.asc
    Search samples
    
ec-sample-tracker search --tag NiFe-LDH --reaction OER
ec-sample-tracker search --synth-date-after 2026-03-01
    List all active samples
    
ec-sample-tracker list --status active
    Log an experimental event
    
ec-sample-tracker log CAT-2026-0042 --event "LSV cycling started" \
  --note "100 cycles in 1M KOH, 10 mA/cmΒ²"
    Export all samples
    
ec-sample-tracker export --format markdown --output samples-report.md
    Generate dashboard
    
ec-sample-tracker dashboard --output sample-dashboard.png