measure-before-optimize SKILL.md skillA

measure-before-optimize from karsten-s-nielsen/mad-scientist-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add karsten-s-nielsen/mad-scientist-skills/measure-before-optimize@git:20260929.7b74d3a

Pins git:20260929.7b74d3a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
karsten-s-nielsen/mad-scientist-skills
Path
plugins/mad-scientist-skills/skills/measure-before-optimize/SKILL.md
Versions recorded
3
Latest version
git:20260929.7b74d3a, committed Sep 29, 2026
First version recorded
Apr 14, 2026
Size
9,362 bytes
Repository stars
3
License
MIT

Pre-change measurement gate for perf-sensitive functions. Use BEFORE modifying any function that has a pytest-benchmark test, appears in a performance baselines file, or is flagged as a hot path in CLAUDE.md / AGENTS.md. Captures baseline median and p95, verifies the change does not regress beyond a configurable threshold, reports the delta. Peer skill to optimization-audit — this one is pre-change; that one is retrospective.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Measure Before Optimize

A pre-change measurement discipline that captures a performance baseline, gates the change on a regression threshold, and reports the delta. Designed as a peer to `optimization-audit`: this skill is pre-change, that one is retrospective.

## When to use this skill

- Before modifying a function that has a `pytest-benchmark` test.
- Before modifying a function listed in the project's performance baselines file (commonly `docs/performance-baselines.md` or `docs/benchmarks.md`).
- Before modifying a function flagged as a hot path in `CLAUDE.md`, `AGENTS.md`, `CONTRIBUTING.md`, or a performance-related document.
- When the user says "optimize X", "speed up Y", "this function is slow", or similar performance-intent phrases.
- When a task touches tracking-scale data, Spark UDFs with strict memory budgets, or any code in a documented hot loop.

## What this skill is NOT for

- Retrospective performance audits — use `optimization-audit` instead.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add karsten-s-nielsen/mad-scientist-skills/measure-before-optimize@sha256:46b20dec6de5075b

The line at the top of this page pins the label git:20260929.7b74d3a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3ygc4qzdyem5eaum.svg)](https://markdownregistry.com/a/art_3ygc4qzdyem5eaum)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Apr 14, 2026 and Sep 29, 2026, about one every 84 days.

versioncommittedcommitsizeaudit
git:20260929.7b74d3a latest2026-09-29 7b74d3a 9,362 BA view · diff
git:20260926.35dafdd2026-09-26 35dafdd 8,849 BA view · diff
git:20260414.9c3849d2026-04-14 9c3849d 8,800 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9362 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

karsten-s-nielsen/mad-scientist-skills · 3 stars · license MIT · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3ygc4qzdyem5eaum
GET https://markdownregistry.com/api/v1/resolve?ref=karsten-s-nielsen/mad-scientist-skills/measure-before-optimize
GET https://markdownregistry.com/api/v1/blob/46b20dec6de5075b5debae1a7c28ea12343b574f162cd7bbf8db56d7dbd61ca7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from karsten-s-nielsen/mad-scientist-skills

AGENTS.md AGENTS.md file
karsten-s-nielsen/mad-scientist-skills · AGENTS.md
git:20260926.35dafdd · audit A · 3 stars
CLAUDE.md CLAUDE.md file
karsten-s-nielsen/mad-scientist-skills · CLAUDE.md
git:20260926.35dafdd · audit B · 3 stars
architecture-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/architecture-audit/SKILL.md · Comprehensive architecture audit with two modes and a single tier (beta). Planning mode evaluates architectural…
git:20260926.35dafdd · audit A · 3 stars
c4 SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/c4/SKILL.md · Creates interactive C4 model architecture diagrams using Structurizr DSL — the official C4 notation by Simon Brown…
git:20260813.1e1da60 · audit B · 3 stars
cognitive-interface-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/cognitive-interface-audit/SKILL.md · Comprehensive cognitive interface audit with two modes and a single tier. Planning mode designs task models, user…
git:20260926.35dafdd · audit A · 3 stars
documentation-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/documentation-audit/SKILL.md · Comprehensive documentation audit with two modes and a single tier. Planning mode designs documentation strategy…
git:20260926.35dafdd · audit A · 3 stars
final-review SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/final-review/SKILL.md · Pre-commit quality gate — reviews all code and documentation for consistency, best practices, and completeness, then…
git:20260929.7b74d3a · audit A · 3 stars
observability-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/observability-audit/SKILL.md · Comprehensive observability audit with two modes and two tiers (beta). Planning mode designs telemetry strategy…
git:20260416.d18ed8c · audit A · 3 stars
optimization-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/optimization-audit/SKILL.md · Comprehensive optimization audit with two modes and a single tier. Planning mode designs performance strategy, capacity…
git:20260929.7b74d3a · audit B · 3 stars
research-discipline SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/research-discipline/SKILL.md · Use when designing or validating a quantitative metric, model, or ranking, when pre-registering an analysis, or before…
git:20261001.d0fd4dd · audit A · 3 stars
security-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/security-audit/SKILL.md · Comprehensive security audit with two modes and two tiers. Planning mode reviews architecture for security gaps (STRIDE…
git:20260724.35d8a81 · audit B · 3 stars
unbiased-review SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/unbiased-review/SKILL.md · Use when reviewing a spec, plan, or implementation produced by another session - verifies its claims against the actual…
git:20260929.7b74d3a · audit A · 3 stars

Every file in karsten-s-nielsen/mad-scientist-skills

Browse by kind, by grade A, or by owner.