agentleFS
DanaResearchGroupDanaResearchGroup/agent-skills/probe/SKILL.md

probe

Skill1 starsChanged 3 months agoMITView on GitHub

Probe a load-bearing premise empirically before proposing or building on it — a claim that is pleasingly convenient, a design's central technical question, a conditional finding whose antecedent needs checking here, or a novelty/prior-art claim inherited from your own evidence base. Use in the same turn you form a recommendation, not after it is accepted; for a check too large to run inline, see references/commissioning-research.md.

16 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use review.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • SentrySkill

    review

    Fixture review skill.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 7 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    The tripwire is convenience: When a premise is the load-bearing step of a recommendation you are about to make, and it is exactly what the …

    line 16
  2. Distinctive:

    Cheapest probe first: Before commissioning a search, try to refute the claim by one line of derivation on its own terms — arithmetic, a …

    line 25
  3. Distinctive:

    Re-run prior art when the frame changes fields: If the current framing moved the problem into an adjacent field, the old literature sweep …

    line 33
  4. Distinctive:

    Kill-check before deep adjudication: Before reasoning at length about a technical question, ask whether a cheap measurement settles it …

    line 41
  5. Distinctive:

    Pair the thesis with its kill-test: When you land on a synthesis, state in the same move what observation would break it.

    line 45
  6. Distinctive:

    Default to inverted — for what's unverified: Treat an unverified load-bearing premise as likely wrong and plan for the inversion, not the …

    line 52
  7. Distinctive:

    Treat it as a defect report, not as evidence.

    line 70
  8. Very specific:

    Don't just note it and move on — the repair is part of the record, paired with the evidence that killed the premise.

    line 78
  9. Very specific:

    When the check requires a real literature or codebase sweep rather than a one-line derivation, see references/commissioning-research.md …

    line 84

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Probe

A probe is a cheap empirical check run against a load-bearing premise before it enters your reasoning. The doctrine — probe before building — lives in the user's global instructions; this is the procedure.

Timing is the lever. A probe run inside the same round that forms a recommendation costs one round of reasoning. The same probe run after the recommendation is accepted costs a full decision cycle plus a retraction. Probe before proposing, not before committing.

The tripwire is convenience. When a premise is the load-bearing step of a recommendation you are about to make, and it is exactly what the argument needs, that is the trigger to probe it — in the same turn, not the next one.

Procedure

  1. Name the load-bearing claim. Of the premises under the recommendation, which one, if false, changes the answer? Probe that one, not the easy one beside it.
  2. Cheapest probe first. Before commissioning a search, try to refute the claim by one line of derivation on its own terms — arithmetic, a derivative, a Bayes update.
  3. Audit inherited claims. A claim you are carrying from your own evidence base — a novelty claim, a "no prior work found," a summary written by an earlier pass — is not verified because it is written down. Check its own provenance tag (inference vs. search) before it does more work.
  4. Re-run prior art when the frame changes fields. If the current framing moved the problem into an adjacent field, the old literature sweep does not cover it. Re-run from scratch in the new field; do not patch the old sweep.
  5. Resolve conditionals now. A finding of the shape "X degrades when Y" is a live query, not a settled fact, until you check whether Y holds here. Do it at the moment you hold the finding, not later.
  6. Kill-check before deep adjudication. Before reasoning at length about a technical question, ask whether a cheap measurement settles it outright. If a measurement gate exists, run it first; prose adjudication is only for what survives the gate.
  7. Pair the thesis with its kill-test. When you land on a synthesis, state in the same move what observation would break it. A synthesis with no attached falsification is a single point of failure.
  8. Report retrieval status. State what you searched, what came back, and — first, in bold — what you could NOT reach. An unstated hole reads as a covered one.
  9. Default to inverted — for what's unverified. Treat an unverified load-bearing premise as likely wrong and plan for the inversion, not the confirmation. A directly observed fact — a test failing at a known line, a stack trace — needs no inversion ceremony, just a fix. A premise that cannot be probed empirically is a design risk to surface, not a footnote to drop.
  10. Probe the claims you author about yourself. Novelty, "nobody has done this," a competitive moat, "only we can build this" — load-bearing premises with the same failure mode as technical ones, and more dangerous, because they read as positioning rather than as facts and so escape the doctrine that would otherwise catch them. Probe before the claim enters a document: a claim removed from a proposal costs the writing as well as the retraction.
  11. Before formalising, list the scoping decisions the formalism rests on. A formal result built while a scoping question about the same object is still open may not survive the answer. One sentence per open dependency, saying what becomes of the formalism under each answer. If the answer is "it doesn't survive," formalise later.

A result that makes an expert look foolish

Treat it as a defect report, not as evidence. When a probe returns something implying a competent practitioner is wrong on their face about their own tool — a trust ordering backwards, a default that contradicts the field — the likeliest explanations are a misreading or a bug in the thing measured, not a discovery. File it as a suspected defect, confirm it independently, and don't spend it in an argument meanwhile. The tell is that the sentence you're about to write reads as a gotcha.

When the probe inverts the premise

Don't just note it and move on — the repair is part of the record, paired with the evidence that killed the premise. See ../domain-modeling/SKILL.md for where that retraction belongs.

Too big to run inline

When the check requires a real literature or codebase sweep rather than a one-line derivation, see references/commissioning-research.md before dispatching it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.