本文へ移動
cccskills
無料GitHub で公開

causal-reasoning-initial-report-of-a-nat

Naturalistic causal reasoning for failures and disputed attribution. Use when postmortems or root-cause debates need reframing. NOT for causal inference, fault trees, or fully observed failures.

インストール方法を見る

含まれるファイル(25)

  • SKILL.md10.4 KB
  • _book_identity.json6.2 KB
  • _raw_response.md113.0 KB
  • CHANGELOG.md635 B
  • diagrams/01_flowchart_decision-points.md815 B
  • diagrams/INDEX.md135 B
  • provenance.json1.0 KB
  • references/causal-stories-as-system-models.md13.1 KB
  • references/causal-story-construction-and-mechanism.md10.2 KB
  • references/closure-and-action-in-causal-reasoning.md9.9 KB
  • references/closure-decisions-and-the-action-understanding-tradeoff.md11.8 KB
  • references/coincidence-correlation-and-causal-initiation.md5.6 KB
  • references/criteria-for-causal-attribution.md10.9 KB
  • references/domain-calibrated-causal-reasoning.md7.2 KB
  • references/domain-expertise-and-causal-frame-selection.md11.6 KB
  • references/five-forms-of-causal-explanation.md15.2 KB
  • references/indeterminate-causation-and-partial-explanations.md12.6 KB
  • references/indeterminate-vs-determinate-problems.md9.8 KB
  • references/INDEX.md2.8 KB
  • references/naturalistic-causal-reasoning-taxonomy.md12.4 KB
  • references/reciprocal-framing-and-causal-search.md10.8 KB
  • references/reciprocal-model-of-sensemaking.md10.1 KB
  • references/reductive-tendency-and-when-to-resist-it.md12.8 KB
  • references/the-reductive-tendency-and-agent-simplification.md9.9 KB
  • references/three-causal-criteria-for-agent-diagnosis.md14.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Causal Reasoning: Initial Report of a Naturalistic Study

Use this skill when the point is not just to name a cause, but to choose the right explanatory frame and stop at the right level of closure.

When to Use

Load this skill when:

  • Diagnosing failures — a system, process, decision, or outcome went wrong and you need to explain why
  • Causal attribution is contested — multiple competing explanations exist and you need a framework for evaluating them
  • The "obvious" cause feels too simple — someone is reaching for a single root cause in a situation that is clearly complex
  • Designing diagnostic agents — an agent or orchestration system must investigate and explain failures
  • Closure is hard — analysis keeps expanding and you need principled criteria for when to stop
  • Explanation type matters — you need to choose how to explain something, not just what to explain
  • Postmortems or retrospectives — organizational, technical, or strategic failure reviews
  • Experts disagree about cause — different framings produce different cause-sets and you need to understand why

NOT for

  • Pure statistical causal inference or do-calculus.
  • Formal fault-tree analysis with known component failure rates.
  • Situations where the cause is fully observed and unambiguous.
  • Implementation-only debugging where the causal frame is already obvious.

Decision Points

flowchart TD
  A[Outcome needs explanation] --> B{Failure determinate and fully observed?}
  B -->|Yes| C[Use a simpler reliability or root-cause method]
  B -->|No| D[Choose the working frame]
  D --> E{Best fit right now?}
  E -->|Event| F[Test reversible trigger causes]
  E -->|Condition| G[Inspect enabling structures]
  E -->|Story| H[Model interacting streams over time]
  E -->|List| I[Enumerate candidates, then upgrade the frame]
  E -->|Abstraction| J[Match known failure patterns]
  F --> K[Apply propensity, reversibility, and covariation]
  G --> K
  H --> K
  I --> K
  J --> K
  K --> L{Enough understanding for the decision at hand?}
  L -->|No| M[Reframe or gather probe evidence]
  L -->|Yes| N[Output action-cause plus causal story]

Use this routing model first:

  • If the "obvious" cause feels too clean, switch frames before digging harder.
  • If the decision is time-sensitive, keep an action-cause and a fuller causal story separate.
  • If experts disagree, inspect the frames they are using before comparing their evidence.

Core Mental Models

1. Five explanation types

Real-world causal reasoning uses five structurally different explanation forms. The form chosen is not neutral; it determines what counts as a relevant cause to search for.

TypeWhat it looks likeDomain bias
Event"X happened, which caused Y" — counterfactual and reversibleSports, military decisions
Abstraction"This is an instance of pattern P" — category-basedLaw, medicine, science
Condition"The environment made this likely or inevitable" — structuralPolicy, safety analysis
List"Factors A, B, C contributed" — enumeration without mechanismJournalism, early diagnosis
Story"A complex interaction of X, Y, Z unfolded over time" — mechanistic narrativeEconomics, complex failures

Why it matters: an analyst using only event-type reasoning in a systemic failure will miss structural conditions. An analyst stuck in list-type reasoning will enumerate causes without modeling interaction.

2. Reciprocal framing

The search for causes and the construction of an explanatory frame happen simultaneously, not sequentially. The frame determines what counts as a relevant cause; the causes found reshape the frame.

[Candidate Causes] <-> [Explanatory Frame]
        each reshapes the other in real time

If you start with the wrong frame, you will systematically miss causes that do not fit it. Changing the frame is not "trying harder"; it is accessing a different search space.

3. Three attribution criteria

These are the workhorses of causal judgment. They operate independently and can produce conflicting verdicts:

  • Propensity: could this plausibly lead to that?
  • Reversibility: would removing this cause eliminate the effect?
  • Covariation: do cause and effect travel together across cases?

Always apply all three. Context can flip the verdict of each.

4. Reduction is both necessary and dangerous

Humans compress dynamic, nonlinear, simultaneous causality into linear chains. This is both:

  • Cognitively necessary — you cannot act on a fully simultaneous multi-causal model
  • Epistemically dangerous — the compression creates a fiction that becomes invisible

The right move is to know which register you are in:

  • Diagnostic mode: resist reduction, hold complexity, and prefer story-type explanation
  • Action mode: accept reduction, identify the actionable cause, and document what remains unresolved

5. Indeterminate causation is normal

In organizational, political, military, and economic domains, there is often no single true cause. Multiple interacting partial causes are the rule. The right output in complex domains is a partial-cause set with explicit uncertainty, not a falsely precise single root cause.

Failure Modes

Root Cause Fundamentalism

Treating "find the single root cause" as the goal of causal analysis. In complex domains, this produces a named cause that absorbs blame while leaving structural vulnerabilities intact.

Frame Blindness

Searching harder inside a failing frame instead of changing the frame. When the search stalls, the failure is often in the framing choice, not in the analyst's effort.

Sequential Compression of Simultaneous Causation

Describing processes that happened in parallel and interacted as though they happened one after another. This is the reductive tendency in its most dangerous form.

Explanation-Type Mismatch

Using event-type reasoning for condition-caused failures, or using a list of factors when a story of interaction is required.

Premature Closure

Achieving closure at the action-cause level and pretending it is the same as structural understanding. Immediate intervention and durable prevention need different outputs.

Shibboleth

If every cause in your answer fits into a clean single-file chain with no enabling conditions, you probably compressed a story into a slogan.

Worked Examples

Example 1: Production outage with a tempting single trigger

Situation:

  • A deploy coincides with a payments outage.
  • Teams want to call the deploy "the root cause."
  • Logs also show queue saturation and a degraded dependency.

Better framing:

  • Event frame: the deploy is a plausible trigger.
  • Condition frame: queue configuration and dependency fragility made the outage likely.
  • Story frame: the deploy altered traffic shape enough to expose those conditions.

Output:

  • Action-cause: roll back or mitigate the deploy-induced traffic change.
  • Causal story: fix queue saturation thresholds and dependency resilience so the same trigger no longer causes collapse.

Example 2: Strategy postmortem with disputed blame

Situation:

  • Sales says pricing caused the miss.
  • Marketing says positioning caused the miss.
  • Leadership says execution discipline caused the miss.

Better move:

  • Fork one lane per frame.
  • Compare which candidate causes each frame surfaces and which ones it cannot see.
  • Keep a partial-cause set instead of forcing a single verdict.

Fork Guidance

Fork when contested attribution or high stakes justify frame diversity:

  • Event lane: isolate reversible decisions and immediate triggers.
  • Condition lane: look for structural enablers and systemic vulnerabilities.
  • Story lane: reconstruct interaction across time.

Keep closure decisions in the parent lane so one actor decides when the evidence is sufficient for action.

Quality Gates

  • The answer names the current explanatory frame and why it fits.
  • Candidate causes are tested with propensity, reversibility, and covariation.
  • Trigger causes are separated from enabling conditions.
  • Uncertainty is explicit when causation is indeterminate.
  • The output includes both an action-cause and a fuller causal story.
  • Closure depth matches the stakes of the decision.
  • Alternative frames are noted when they would surface different causes.

Reference Map

Load these files on demand when the specific sub-problem arises. Do not load all at once.

FileLoad When...
diagrams/01_flowchart_decision-points.mdYou need the decision flow as a standalone artifact for review or handoff.
references/five-forms-of-causal-explanation.mdYou need to identify or choose the right explanation type.
references/reciprocal-framing-and-causal-search.mdThe search for causes is stalling or producing thin results.
references/three-causal-criteria-for-agent-diagnosis.mdYou are evaluating specific candidate causes.
references/reductive-tendency-and-when-to-resist-it.mdThe causal account feels too linear or too simple.
references/indeterminate-causation-and-partial-explanations.mdMultiple causes are present and "root cause" pressure is distorting the analysis.
references/domain-expertise-and-causal-frame-selection.mdAn expert's framing choice seems opaque or contested.
references/causal-stories-as-system-models.mdThe failure is complex, systemic, or organizational.
references/closure-decisions-and-the-action-understanding-tradeoff.mdAnalysis must end and action must begin.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Use for insight, reframing, contradiction, impasse, and anomaly-driven problem solving when execution effort no longer helps. NOT for routine optimization, error correction, or well-specified tasks with known solution paths.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Apply cognitive task analysis to expert work that depends on perceptual cues, branching judgment, and recurring monitoring loops. Use when decomposing expert capability into agent structure, simulation design, or validation interviews. NOT for ordinary step-by-step SOP capture or simple pipelines with no tacit cue layer.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

curiositech のスキルをすべて見る

このスキルの問題を報告する