← Back to Skills Marketplace
xrayxiaoruiyang-pixel

EC Sample Tracker

by xrayxiaoruiyang-pixel · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
132
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ec-sample-tracker
Description
Track and manage electrochemistry samples from synthesis to characterization with data linking, event logging, search, export, and dashboard visualization.
README (SKILL.md)

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 \x3Ccommand> [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
Usage Guidance
This appears to be a coherent, local CLI tool for tracking lab samples. Points to consider before installing/running: - Source provenance: the package has no homepage and an unknown source — prefer code from a known repository or author when possible. - Local file access: the tool creates/updates config.yaml and samples.db in its working directory and will read any file paths you pass to the link command (so do not link sensitive files). - Dependencies: it imports optional Python packages (PyYAML, matplotlib, Pillow, scipy, numpy). You may need to install these in the environment you run it in; consider using a virtualenv. - Run isolation: because this is an executable script from an unknown source, consider running it in a sandbox/container or inspect the code locally before execution. - Backups: the script updates next_id in config.yaml and writes to the SQLite DB — back up existing data if you plan to run it against a directory with important files. If you want, I can list the exact optional Python dependencies to install, or point out the exact lines that read/write config and DB for easier code inspection.
Capability Analysis
Type: OpenClaw Skill Name: ec-sample-tracker Version: 1.0.0 The ec-sample-tracker skill bundle is a legitimate tool designed for managing electrochemistry lab samples and their associated metadata. The Python script (ec-sample-tracker.py) implements standard CRUD operations using a local SQLite database with parameterized queries to prevent SQL injection. It includes features for data export, import, and visualization using matplotlib. No evidence of data exfiltration, malicious execution, or prompt injection was found; the code logic is consistent with the stated purpose in SKILL.md.
Capability Assessment
✓ Purpose & Capability
Name/description (electrochemistry sample tracker) match the code and SKILL.md: CLI commands for add/list/link/search/export/dashboard, an SQLite DB, and a YAML config are all present and expected.
ℹ Instruction Scope
SKILL.md and the CLI instruct local operations only (creating samples.db, writing config.yaml, generating PNG/CSV/MD exports). The code will read files you explicitly link (e.g., CSV/XLSX data) and attempts limited automatic parsing for 'ec' links if scipy/numpy are available. There are no network calls, subprocess execs, or directives to read unrelated system state, but the tool will read any filesystem paths you provide and will write config.yaml and samples.db in the working directory.
ℹ Install Mechanism
No install spec is provided (no packages/binaries are pulled). The Python script imports optional libraries (yaml, matplotlib, PIL, scipy, numpy) but does not declare them in an install manifest—this is a minor inconsistency (user must ensure Python deps are installed) but not a security concern by itself.
✓ Credentials
The skill requests no environment variables, credentials, or special config paths. Files it uses (config.yaml, samples.db, user-provided data files) align with its stated purpose.
✓ Persistence & Privilege
always is false and the skill does not attempt to alter other skills or system-wide agent settings. It does persist its own config (config.yaml) and database (samples.db) in the working directory, which is expected behavior for this type of tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ec-sample-tracker
  3. After installation, invoke the skill by name or use /ec-sample-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of ec-sample-tracker — a comprehensive sample tracking tool for electrochemistry labs. - Track physical samples from synthesis through all characterization and storage stages. - Register, search, log events, and attach files/notes to each sample. - Visual dashboard (PNG) summarizes sample status, reaction types, locations, and recent activity. - Flexible export/import in CSV, JSON, and Markdown formats. - SQLite-backed database with detailed schema for sample records, file links, and experimental events.
Metadata
Slug ec-sample-tracker
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is EC Sample Tracker?

Track and manage electrochemistry samples from synthesis to characterization with data linking, event logging, search, export, and dashboard visualization. It is an AI Agent Skill for Claude Code / OpenClaw, with 132 downloads so far.

How do I install EC Sample Tracker?

Run "/install ec-sample-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is EC Sample Tracker free?

Yes, EC Sample Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does EC Sample Tracker support?

EC Sample Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created EC Sample Tracker?

It is built and maintained by xrayxiaoruiyang-pixel (@xrayxiaoruiyang-pixel); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments