close-the-gap-to-the-published-number

Solid

Use at Stage 05 and Stage 06 the moment a reproduction lands materially off a number the source study published — a different order of magnitude, an inverted trend, a collapsed estimate. Covers why the gap is a defect in your pipeline until you have shown otherwise, how much of the remaining budget to spend closing it, and what to write when it will not close.

AI & Automation 804 stars 25 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 85/100

Stars 20%
97
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# A disagreement with the published number is a bug report addressed to you You reran the study and got 0.140 V where the paper got 0.0117 V. You have two moves available. One is to write the discrepancy down carefully, attribute it to a difference in setup, and move on to the next section. The other is to treat the gap as evidence that something in your pipeline is wrong, and spend budget until it closes or until you can name the specific thing that makes it irreducible. The first move feels like honesty and reads as one. It is also, almost always, wrong on the facts: a twelvefold gap against a published measurement is far more often a bug than a boundary. And it is scored as what it is — an analysis whose methodology is defensible and whose numbers are not. ## The rule **A quantitative disagreement with the source is a defect with an owner until an experiment says otherwise.** Not a limitation, not a caveat, not a scope note. The owner is this run. Order of magnitude matters. Treat these differently: | gap | reading | |---|---| | within the source's own stated uncertainty | agreement; say so and move on | | a factor of 1.5-3, or a shifted intercept | a parameter, a normalisation, a split, a unit | | a factor of ten, an inverted sign, an inverted trend | a bug; nothing else does this | | your estimator collapses to a constant or to zero | a bug; the model learnt nothing | The last two rows are not results. A latent charge that collapses to 0.0002 e, a curve that sits ...

Details

Author
tangxiangru
Repository
tangxiangru/AutoR
Created
5 months ago
Last Updated
today
Language
Python
License
NOASSERTION

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

evidence-not-assertion

Use whenever a number, a comparison or a claim is about to enter a stage summary or the report — at analysis and writing, and any time you are tempted to state a value you have not computed in this run. Covers where a number must come from, what to do when the experiment did not run, and why an honest gap outscores a plausible sentence.

804 Updated today
tangxiangru
AI & Automation Solid

a-value-you-did-not-measure-still-has-a-source

Use at Stage 06 and Stage 07 when a deliverable the task named cannot be produced by this run at all — a wet-lab measurement, a synthesised material, a proprietary benchmark, hardware you do not have. Covers the difference between fabricating a number and citing one, where the cited value belongs, and why omitting the section is the worst of the three options.

804 Updated today
tangxiangru
AI & Automation Listed

gap-and-contradiction-register

Maintain `00-control/assumptions-questions-and-contradictions.md` — the assumptions and open-questions register (`AQ-####`) and the contradiction register (`CT-####`) — classifying each entry as blocking, material but non-blocking, or minor, and routing blocking gaps to owner resolution before drafting proceeds. Use when a source is silent on a required topic, when two sources disagree, or when a verification pass reports conflicting evidence for the same claim. This skill MUST be consulted because a documented unknown is a deliverable and a silently-filled gap is a defect — a package that papers over a contradiction transfers risk to the reader without telling them it exists.

6 Updated 2 weeks ago
synaptiai