run-provenance

run-provenance is a skill for Claude Code, Codex from uchicago-dsi/ai-sci-skills. It costs 73 tokens per session (2,085 once invoked), scanned A, original, MIT.

A method for recording where a computational result came from and how to recreate it. It chooses how much detail to save based on whether the run is a quick check, an exploratory job, or evidence others will rely on.

In plain words
What is it for?
Use it before launching computational runs, publishing reusable outputs, freezing queued work, or deciding whether a branch or worktree is adequately recorded.
Why use it?
Without the source revision, command, settings, environment, and input identities, later readers may not be able to reproduce an output or judge whether it is trustworthy. Recording these details before expensive work prevents that gap.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it before launching computational runs, publishing reusable outputs, freezing queued work, or deciding whether a branch or worktree is adequately recorded.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/uchicago-dsi/ai-sci-skills/run-provenance
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.

Any agent
npx skills add uchicago-dsi/ai-sci-skills --skill run-provenance
Clone the repo
git clone --depth 1 https://github.com/uchicago-dsi/ai-sci-skills

Made for: Claude Code, Codex.

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 run-provenance

README.md
[![agentmods](https://agentmods.dev/badge/skills/uchicago-dsi/ai-sci-skills/run-provenance/github.svg)](https://agentmods.dev/skills/uchicago-dsi/ai-sci-skills/run-provenance)
Your own site
<a href="https://agentmods.dev/skills/uchicago-dsi/ai-sci-skills/run-provenance"><img src="https://agentmods.dev/badge/skills/uchicago-dsi/ai-sci-skills/run-provenance/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for run-provenance

Your own site · 80×15
<a href="https://agentmods.dev/skills/uchicago-dsi/ai-sci-skills/run-provenance"><img src="https://agentmods.dev/badge/skills/uchicago-dsi/ai-sci-skills/run-provenance.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,085 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00073 $0.02085
Opus 5.5 $0.00029 $0.00834
Sonnet 5.5 $0.00015 $0.00417
Haiku 4.5 $0.00007 $0.00209

Measured 20d ago against content hash 28d1726778a9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

run-provenance 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 20d ago.

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/run-provenance/SKILL.md · 165 lines

How it starts

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

Run Provenance

Provenance exists so a later reader can tell what produced an artifact and remake it. Everything below scales with what the artifact is for: a probe nobody will reuse owes very little, and a parent that other runs consume owes all of it.

Choose The Tier Before You Launch

Use three tiers so iteration stays fast without weakening durable evidence.

  1. Developer checks. Compile/import checks, config validation, dry runs, and disposable local mechanics probes may use uncommitted code and need no provenance artifact. A read-only diagnostic that consumes immutable inputs and writes nothing anything else will consume is this tier by default; it needs no deliberation about which tier applies.
  2. Exploratory scheduled smokes. Uncommitted code is allowed when the run root automatically records the full base commit SHA, exact command, config hash, environment identity, immutable data/parent hashes, working-tree status, and an exact binary patch or source snapshot covering every dirty or untracked execution path. Report these results only as preliminary, with that provenance. They may not become reusable parents or decision-grade evidence.
  3. Decision-grade, expensive, or reusable runs. Long training, final comparisons, promotion/retirement evidence, and artifacts consumed as parents must execute from a clean checkout pinned to a full 40-character commit SHA, with every invoked code and config path tracked and committed. A dirty shared checkout should use a clean commit-pinned worktree rather than blocking unrelated development.

For tier 3, generate the run README and machine-readable provenance before the first scientific kernel or optimizer update. Record the full commit SHA, exact command and config hash, environment identity, immutable data/parent manifest hashes, and clean execution status; the commit already determines the tree and transitive source contents. Fail closed when a field is absent or the execution checkout differs from the commit. Resume with the same commit and bound hashes; a code change requires a new commit and a new semantic run slug or explicitly versioned attempt. Generate this automatically rather than spending agent effort on long narrative prose.

Read the full file on GitHub · 165 lines

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. 20d ago Changed · +7 lines 28d1726778a9
  2. 26d ago Changed · +35 lines fe6c087045bc
  3. 1mo ago First seen · 123 lines · 73 tokens per session scan A 6125bdce639a

Subscribe to this mod's changes

run-provenance is a skill published in the GitHub repository uchicago-dsi/ai-sci-skills (20 stars, last pushed 4d ago), licensed MIT. It adds 73 tokens to every session and 2,085 once invoked, about $0.0003 per session on Opus 5.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-09-22.

Related

Other skills, from other repositories

instrument-data-to-allotrope

Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV. Use this skill when scientists need to standardize instrument data for LIMS systems, data lakes, or downstream analysis. Supports auto-detection of instrument types. Outputs include full…

anthropics/knowledge-work-plugins · 123 tokens

matlab

Builds, reviews, migrates, and plans MATLAB or GNU Octave numerical workflows. Use for arrays, tabular/time data, tests, projects, graphics, MAT files, and explicit Python interoperability.

K-Dense-AI/scientific-agent-skills · 44 tokens

exploratory-data-analysis

Performs bounded, local exploratory analysis of explicitly supported scientific files. Supports redacted CSV/TSV/JSON profiles; optional NumPy, HDF5, FASTA/FASTQ, and basic image metadata inspection; missingness/leakage audits; outlier and transformation sensitivity; and rigorous EDA report scaffolds. Other domain…

K-Dense-AI/scientific-agent-skills · 83 tokens

phylogenetics

Builds and analyzes phylogenetic trees using MAFFT multiple sequence alignment, IQ-TREE maximum likelihood with ModelFinder and branch support, and FastTree approximate inference. Uses ETE3 for tree summaries and visualization. Applies to homologous nucleotide or protein sequences, microbial gene trees, protein…

K-Dense-AI/scientific-agent-skills · 71 tokens

research-engineer

An uncompromising Academic Research Engineer. Operates with absolute scientific rigor, objective criticism, and zero flair. Focuses on theoretical correctness, formal verification, and optimal implementation across any required technology.

davila7/claude-code-templates · 43 tokens

presenting-conference-talks

Generates conference presentation slides (Beamer LaTeX PDF and editable PPTX) from a compiled paper with speaker notes and talk script. Use when preparing oral talks, spotlight presentations, or invited talks for ML and systems conferences.

Orchestra-Research/AI-Research-SKILLs · 53 tokens