workflow-engine-mapper

workflow-engine-mapper is a skill for Claude Code, Codex from HeshamFS/materials-simulation-skills. It costs 68 tokens per session (2,591 once invoked), scanned A, original, Apache-2.0.

A guide for choosing how to organize materials-science simulations into workflows. A workflow is a repeatable series of calculations; the guide compares one-off scripts with jobflow, atomate2, AiiDA, and pyiron.

In plain words
What is it for?
Use it to plan simulation campaigns, dependency graphs, restart behavior, provenance records, data storage, and migrations from simple scripts to managed workflow systems.
Why use it?
It helps replace ad hoc scripts with an approach that fits the number of calculations, need for restart after failure, audit history, and use of remote high-performance computing. It avoids adding workflow infrastructure when a small local experiment does not need it.

Skill for Claude CodeCodex

Part of the simulation-workflow plugin — 7 skills shipped together , and of reproducible-campaigns, full

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/heshamfs/materials-simulation-skills/workflow-engine-mapper
Any agent
npx skills add HeshamFS/materials-simulation-skills --skill workflow-engine-mapper
Clone the repo
git clone --depth 1 https://github.com/HeshamFS/materials-simulation-skills

Made for: Claude Code, Codex.

Or install simulation-workflow, the plugin that ships this one along with the rest of its 7 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for workflow-engine-mapper

README.md
[![agentmods](https://agentmods.dev/badge/skills/heshamfs/materials-simulation-skills/workflow-engine-mapper.svg)](https://agentmods.dev/skills/heshamfs/materials-simulation-skills/workflow-engine-mapper)
Your own site
<a href="https://agentmods.dev/skills/heshamfs/materials-simulation-skills/workflow-engine-mapper"><img src="https://agentmods.dev/badge/skills/heshamfs/materials-simulation-skills/workflow-engine-mapper.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,591 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00068 $0.02591
Opus 5 $0.00034 $0.01295
Sonnet 5 $0.00014 $0.00518
Haiku 4.5 $0.00007 $0.00259

Measured 5d ago against content hash bbed5bf05c7c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

workflow-engine-mapper scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/workflow_engine_mapper.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/simulation-workflow/workflow-engine-mapper/SKILL.md · 154 lines

How it starts

The opening of the file, as written. The whole thing — 154 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Workflow Engine Mapper

Goal

Choose the smallest workflow structure that preserves reproducibility, restartability, and provenance for a materials simulation task.

Requirements

  • Python 3.10+
  • No external dependencies
  • Works on Linux, macOS, and Windows

Inputs to Gather

Input Description Example
Task Workflow purpose VASP relax-static-DOS for 200 structures
Code Main simulation engine vasp, qe, lammps, ase
Runs Approximate number of calculations 200
Provenance Whether audit trail matters true
Restart Whether jobs may resume after failure true
HPC Whether remote scheduler is required true

Decision Guidance

  • Use one-off scripts for fewer than 5 local exploratory runs (no provenance, no HPC).
  • Use jobflow/atomate2 when the workflow is Python-native and Materials Project style input sets are useful.
  • Use AiiDA when provenance-critical work is also remote (HPC) or large (>= 50 runs) — i.e. long-lived, database-backed campaigns. For smaller local provenance needs, atomate2 (Materials Project codes, >= 10 runs) or jobflow stores already capture inputs, outputs, code version, and environment, so the mapper recommends those instead of the heavier AiiDA stack.
  • Use pyiron when interactive atomistic workflows, notebooks, and job management are the primary user surface (ASE/LAMMPS without strict provenance).

The recommendations are emitted in a fixed precedence so the prose and the implemented thresholds agree: an explicit --preferred engine overrides everything; otherwise one-off (small local, no provenance/HPC) -> AiiDA (provenance AND remote/large) -> atomate2 (VASP/QE/CP2K/force-field, >= 10 runs) -> pyiron (ASE/LAMMPS, no provenance) -> jobflow (fallback).

Script Outputs

scripts/workflow_engine_mapper.py emits:

  • recommended_engine
  • dag_pattern
  • provenance_requirements
  • restart_strategy
  • storage_layout
  • migration_triggers
  • notes

Read the full file on GitHub · 154 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 154 lines · 68 tokens per session scan A bbed5bf05c7c

Subscribe to this mod's changes

workflow-engine-mapper is a skill published in the GitHub repository HeshamFS/materials-simulation-skills (65 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 68 tokens to every session and 2,591 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

jupyter-notebook

Iterative Python via live Jupyter kernel (hamelnb).

NousResearch/hermes-agent · 18 tokens

paper-revision-author

Revise independently drafted paper sections into one coherent LaTeX body before the abstract is written.

opensquilla/opensquilla · 24 tokens

batch-processing-clinical-text

Run large-scale batch NER, PII extraction, or de-identification over many clinical notes on-device with OpenMed, with sharding, checkpointing, resumability, and append-only JSONL output. Use when the user needs to process a corpus or folder of notes, de-identify a dataset, run NER over thousands of documents, build a…

maziyarpanahi/openmed · 161 tokens

coding-hcc-risk-adjustment

Maps chronic conditions extracted by OpenMed to CMS-HCC V28 risk-adjustment categories and estimates a RAF (Risk Adjustment Factor) score as decision support. Use when the user wants to surface risk-adjustable diagnoses from notes, map ICD-10-CM codes to HCC categories, estimate or reconcile a patient/panel RAF, find…

maziyarpanahi/openmed · 200 tokens

coding-icd10

Suggests candidate ICD-10-CM diagnosis codes (and ICD-10-PCS procedure codes) for diagnoses and procedures extracted by OpenMed, with rationale and a human-coder caveat. Use when the user wants to code a problem list, map a diagnosis span to a billable ICD-10-CM code, route a finding to the right chapter, cross-walk…

maziyarpanahi/openmed · 209 tokens

detecting-pv-signals

Computes disproportionality signals — PRR, ROR, EBGM, and IC (BCPNN) — over FAERS / OpenFDA drug-event data to flag potential safety signals. Use when the user wants to mine spontaneous-report data for drug-reaction associations, build a 2x2 contingency table, compute a Proportional Reporting Ratio or Reporting Odds…

maziyarpanahi/openmed · 218 tokens