agentsclimarketplace

Structured reasoning

Skill ralfyishere/rules-with-receipts/.claude/skills/structured-reasoning

A quality pack for Claude Code that ships with its own eval harness and honest A/B evidence — rules with receipts, not vibes.

Install
npx -y skills add ralfyishere/rules-with-receipts --skill structured-reasoning

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Pick and apply the right reasoning framework for the problem - first principles, tradeoff analysis, decision matrix, root-cause analysis, steelman, evidence grading, risk/reward, sequencing. Activate for decisions between options, evaluations of ideas or arguments, strategy questions, prioritization, "should we X or Y", "is this a good idea", recurring problems, and any analysis where unstructured pro/con listing would produce mush. Also activate when reasoning feels stuck or circular - the fix is usually a better frame.

SKILL.md

7.1 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it

Structured Reasoning

Purpose

Hard questions answered with unstructured intuition produce confident mush — conclusions that feel reasoned but can't show their work. A named framework makes reasoning inspectable: the user can see the criteria, weights, and evidence, and disagree with a specific step instead of the vibe. The skill has two halves: choosing the right frame (most of the value) and executing it honestly.

When to use this skill

  • Choosing between options: tools, architectures, strategies, candidates, plans.
  • Evaluating an idea, proposal, or argument — especially one you're inclined to agree with.
  • Prioritization and ordering questions; recurring problems that keep coming back.
  • When your own reasoning is circling: restating the same considerations without converging.

When NOT to use this skill

  • Questions with verifiable answers — go verify (live-state-truth), don't deliberate.
  • Low-stakes choices where any option is fine: pick one and say why in a clause.
  • Don't stack frameworks for show. One frame, well executed, beats three decorative ones. Two is the practical maximum (e.g., evidence grading feeding a decision matrix).

Operating procedure

Step 1 — Classify the question, pick the frame:

FrameworkUse whenOutput looks like
First principlesInherited assumptions are suspect; novel problem; "we've always done it this way"The problem rebuilt from known constraints upward; assumptions confirmed or discarded
Tradeoff analysis2–3 viable options differing along different dimensionsPer-option: what you gain, what you pay, when it wins
Decision matrix3+ options × 3+ criteria; transparency matters; a group must alignWeighted criteria table with scores and the reasoning behind each score
Root-cause analysis (5 whys / causal chain)A problem recurs despite fixes; symptom vs. disease unclearCausal chain from symptom to actionable cause
Steelman / weakman checkEvaluating an argument or proposal; checking your own positionStrongest version of the opposing view, engaged honestly
Evidence gradingSources conflict; claims vary in reliabilityClaims ranked: verified > strong source > weak source > anecdote > speculation
Risk/rewardBets under uncertainty; asymmetric outcomesUpside × probability vs. downside × probability, plus reversibility
SequencingOrder matters; dependencies and unlock effectsOrdered plan with the "why this first" argument

Step 2 — Name the frame in your output. "Treating this as a tradeoff between X and Y" — this lets the user reject the frame, which is cheaper than rejecting the conclusion.

Step 3 — Execute honestly. The failure mode of every framework is decoration: building the matrix after deciding, steelmanning weakly, grading your preferred source generously. Fill in the structure before forming the conclusion, and let the structure be allowed to surprise you.

Step 4 — Conclude with the frame's output, plus what would change it. "Option B wins on these weights; it flips to A if latency matters more than cost" — the sensitivity note is what makes the analysis reusable when circumstances shift.

Framework selection heuristics

  • Stuck in circles → your frame is wrong, not your effort. Step back to Step 1.
  • Everyone agrees too fast → run a steelman of the rejected option.
  • The decision keeps re-litigating → decision matrix; the disagreement is usually about weights, and the matrix surfaces that.
  • The plan feels overwhelming → sequencing; the question isn't "how do all of this" but "what first."
  • The argument sounds great but you can't say why → evidence grading; charisma and support are different axes.

Quality bar

  • The frame fits the question (a decision matrix for a two-option tradeoff is overhead; a pro/con list for a 5×5 decision is mush).
  • The structure was filled before the conclusion was written — the analysis could in principle have come out the other way.
  • Scores, weights, and grades come with their reasoning; a bare number is an opinion in a costume.
  • The conclusion includes its sensitivity: what change of input flips it.

Common failure modes

  • Framework theater: the matrix that ratifies a pre-made decision. Detectable when every criterion happens to favor the same option — real decisions have losers on some rows.
  • Weakmanning: "some might say X, but that's obviously wrong" — engaging the weakest opposing argument. The steelman row exists to force the strongest.
  • False precision: weights to two decimal places on gut-feel scores. Coarse honest scores (1–3, L/M/H) beat precise invented ones.
  • Ignoring reversibility: treating a reversible choice with Critical-grade deliberation, or an irreversible one casually. Reversibility is a first-class input to risk/reward.
  • Frame-shopping: trying frames until one endorses your prior. If two frames disagree, that disagreement is the finding to report.

Example

"Should we build the integration in-house or buy the vendor solution?"

Frame: tradeoff analysis + risk/reward (two frames, each earning its place). Build: gain control and no per-seat fees; pay 6–8 weeks of the team's roadmap and permanent maintenance. Buy: gain 2-week deployment and vendor support; pay $30k/yr and dependency on vendor roadmap. Risk asymmetry: buy is reversible (annual contract, standard data export — verified in their docs); build is not (sunk engineering). Recommendation: buy now; revisit at renewal with real usage data. Flips if: usage grows past ~$80k/yr equivalent, or the vendor can't meet the compliance requirement (unverified — check before signing).

Works with sibling skills

  • verification-discipline grades the inputs; a rigorous frame over ungraded claims is precision built on sand.
  • adversarial-verify attacks the conclusion afterward; the steelman row is its in-frame cousin.
  • output-structuring renders the result (a decision memo, usually); failure-mode-awareness feeds the downside rows of risk/reward.
  • deep-decomposition uses sequencing as its ordering engine.

Provenance and maintenance

Written 2026-07 as part of a portable, project-agnostic quality pack. Frameworks listed are standard, public reasoning tools. Re-verify by reviewing recent analyses: if conclusions never surprise (structure always ratifies the first instinct), step 3 discipline is failing. Add domain frames your work uses often (e.g., expected-value trees, pre-registered success metrics) as new rows.

Gives 0 of the 12 instructions most roadmap strategy skills give in ~1.4k tokens

Counted across 591 of the 672 authors here whose files we hold, read 2026-08-06

  • read product marketing context before asking questionsin 21 of 591, across 10 files
  • base price on perceived value, not costin 15 of 591, across 4 files
  • compact after finalizing a planin 14 of 591, across 9 files
  • differentiate tiers using features, limits, or supportin 14 of 591, across 3 files
  • use Van Westendorp to find acceptable price rangein 13 of 591, across 2 files
  • use MaxDiff to identify highly valued featuresin 13 of 591, across 2 files
  • map topics to buyer journey stagesin 12 of 591, across 6 files
  • Extract domain capabilities and classify subdomainsin 11 of 591, across 1 file
  • Define bounded contexts around consistency and ownershipin 11 of 591, across 1 file
  • Establish a ubiquitous language glossary and anti-termsin 11 of 591, across 1 file
  • Capture context boundaries in ADRs before implementationin 11 of 591, across 1 file
  • Open the strategic design template if neededin 11 of 591, across 1 file

Said here and by no other author read

  • classify the question and pick one frame
  • name the chosen frame in the output
  • fill in the structure before forming the conclusion
  • include reasoning for all scores, weights, and grades
  • conclude with the frame output
  • state what input change would alter the conclusion

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.