explaining-derivations SKILL.md skillA

explaining-derivations from chgagne/claude-skills-research is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add chgagne/claude-skills-research/explaining-derivations@git:20260816.89dabff

Pins git:20260816.89dabff in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
chgagne/claude-skills-research
Path
explaining-derivations/SKILL.md
Versions recorded
5
Latest version
git:20260816.89dabff, committed Aug 16, 2026
First version recorded
Aug 15, 2026
Size
17,084 bytes
Repository stars
5
License
MIT

Use when a proof or derivation needs to be made explicit step by step — expanding a paper's algebra for a reader without formal mathematical training, producing a worked companion document, or establishing whether a derivation can be justified at all. Triggers on "explain this derivation", "walk me through this proof", "expand the algebra", "I can't follow this step", "make this readable for a non-mathematician", or a referee needing to show why a step does not follow.

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

# Explaining Derivations

## Overview

**An expansion that cannot be completed is evidence against the derivation.**

That is the thesis, and it is what separates this skill from pedagogy. Making a
proof explicit is useful in itself — but the moment a step resists being made
explicit, you have learned something about the proof rather than about the reader.
A step nobody can justify leaves this skill as a gap-ledger row with a severity,
and that ledger feeds back into the review as findings.

So the deliverable is two things at once: a standalone LaTeX document per theorem,
readable by an undergraduate engineer or an ML graduate student without formal
maths training, **and** a ledger of every step that could not be written down.

**Core principle: never manufacture a justification.** The register that reads
best is also the one that most invites a plausible-sounding reason for a step
nobody checked. Every guard below exists for that.

## Run it

```sh
python3 ~/.claude/skills/explaining-derivations/assets/run-explain.py main.tex \
    --out derivations/ --level grad-ml --plan-only
```

Run it by absolute path from the paper directory. Stdlib only — no install, no
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add chgagne/claude-skills-research/explaining-derivations@sha256:36ef67776b4a1e05

The line at the top of this page pins the label git:20260816.89dabff, 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_o66fgcgz4k65hrrn.svg)](https://markdownregistry.com/a/art_o66fgcgz4k65hrrn)

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

Versions

The registry has recorded 5 versions of this file, between Aug 15, 2026 and Aug 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260816.89dabff latest2026-08-16 89dabff 17,084 BA view · diff
git:20260816.248f9552026-08-16 248f955 15,625 BA view · diff
git:20260816.ced334c2026-08-16 ced334c 14,206 BA view · diff
git:20260816.a7e116e2026-08-16 a7e116e 12,390 BA view · diff
git:20260815.b4a07062026-08-15 b4a0706 10,208 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 (17084 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

chgagne/claude-skills-research · 5 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_o66fgcgz4k65hrrn
GET https://markdownregistry.com/api/v1/resolve?ref=chgagne/claude-skills-research/explaining-derivations
GET https://markdownregistry.com/api/v1/blob/36ef67776b4a1e05a0adab049eeb7aefee46df7cf075eb6817243df4cb2e3d7e

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 chgagne/claude-skills-research

self-surveying-literature SKILL.md skill
chgagne/claude-skills-research · _evals/surveying-literature/self-skill/SKILL.md · Audit a research paper draft (LaTeX sources + .bib) for related work it should cite but does not, above all close prior…
git:20261009.6f52569 · audit A · 5 stars
self-verifying-bibliography SKILL.md skill
chgagne/claude-skills-research · _evals/verifying-bibliography/self-skill/SKILL.md · Check a BibTeX bibliography against the real published record. Finds fabricated or non-existent references, wrong…
git:20261009.3a873fd · audit A · 5 stars
collaborating-on-research SKILL.md skill
chgagne/claude-skills-research · collaborating-on-research/SKILL.md · Use when working with a researcher on a long-running research project across many sessions — opening or closing a…
git:20260817.136fa75 · audit A · 5 stars
comparing-papers SKILL.md skill
chgagne/claude-skills-research · comparing-papers/SKILL.md · Use when comparing a draft against specific prior work head to head — checking whether a baseline was trained at the…
git:20260812.4c0299b · audit A · 5 stars
proofreading-paper-writing SKILL.md skill
chgagne/claude-skills-research · proofreading-paper-writing/SKILL.md · Use when asked to proofread, polish, or critique the writing of an academic paper from its LaTeX sources — grammar and…
git:20261009.2091ec8 · audit A · 5 stars
reviewing-paper-sources SKILL.md skill
chgagne/claude-skills-research · reviewing-paper-sources/SKILL.md · Use when asked to review, critique, or assess an academic paper from its LaTeX sources — including pre-submission…
git:20260926.af6ea48 · audit A · 5 stars
running-cluster-experiments SKILL.md skill
chgagne/claude-skills-research · running-cluster-experiments/SKILL.md · Use when planning, budgeting, submitting or resuming a multi-job experiment campaign on a Slurm/HPC cluster — sizing…
git:20260812.12926b4 · audit A · 5 stars
surveying-literature SKILL.md skill
chgagne/claude-skills-research · surveying-literature/SKILL.md · Use when finding related work a draft may have missed, checking whether a contribution has already been published, or…
git:20261016.40659e0 · audit A · 5 stars
using-drac-clusters SKILL.md skill
chgagne/claude-skills-research · using-drac-clusters/SKILL.md · Use when working on a Digital Research Alliance of Canada (DRAC, Alliance, formerly Compute Canada) HPC cluster such as…
git:20260814.fdf4923 · audit B · 5 stars
verifying-bibliography SKILL.md skill
chgagne/claude-skills-research · verifying-bibliography/SKILL.md · Use when checking a .bib or reference list for incorrect or fabricated entries — wrong titles, invented co-authors…
git:20261009.18f8d6d · audit A · 5 stars
verifying-proofs SKILL.md skill
chgagne/claude-skills-research · verifying-proofs/SKILL.md · Use when checking the mathematics of a paper rather than its claims — verifying a theorem's proof, an algebraic…
git:20260817.78f3c11 · audit A · 5 stars

Every file in chgagne/claude-skills-research

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