Reasoning Causal

by aiskillstore

skill

Execute evidence-based decision-making through 6-stage causal flow. Use for known processes, operational execution, and decisions with clear cause-effect chains.

Skill Details

Repository Files

12 files in this skill directory


name: reasoning-causal description: Execute evidence-based decision-making through 6-stage causal flow. Use for known processes, operational execution, and decisions with clear cause-effect chains.

Causal Reasoning

Execute systematic cause-effect reasoning. The logic of process and action.

Relationship to Goals

Threads are the execution layer for goals. Goals define what to achieve; threads define how.

Goal (goal-setter)
  └── Subgoal
        └── Thread (reasoning-causal) ← executes via 6-stage flow
              └── Learning → updates Goal state (goal-tracker)

Thread types:

  • Goal-linked: Created from subgoals, has goal_id in metadata
  • Reactive: Created from signals (no goal), may spawn or link to goal

Type Signature

Causal : Input → Hypothesis → Implication → Decision → Action → Learning

Where:
  Input       : Observation × Context → FactualStatement
  Hypothesis  : FactualStatement × CanvasAssumption → TestableHypothesis
  Implication : TestableHypothesis → (Impact × Probability × Timeline)
  Decision    : Implication × Alternatives → Commitment
  Action      : Commitment → [ExecutableTask]
  Learning    : [ExecutedTask] × Outcomes → CanvasUpdate × GoalUpdate

When to Use

  • Process execution with known steps
  • Decision with clear cause-effect chain
  • Operational workflows (sales, marketing, engineering)
  • Canvas hypothesis testing
  • Action planning and execution
  • Executing subgoals (goal-linked threads)

Thread Types

Type Location Use For
Business threads/operations/{name}/ Strategic decisions, product changes
Sales threads/sales/{name}/ Deal pipelines, prospects
Marketing threads/marketing/{name}/ Campaigns, content launches
Engineering threads/engineering/{name}/ Requirements → specifications

Thread-specific details: See references/threads/{type}.md


6-Stage Flow

Execute stages sequentially. Each stage produces a markdown file in the thread directory.

Stage 1: Input

File: 1-input.md Purpose: Capture factual observation that triggers the flow.

Content:

  • What happened? (fact, not opinion)
  • When? Where? Who observed?
  • Raw data/evidence links
  • Context (what we believed before)

Rules:

  • Facts only, no interpretation
  • No solutions or recommendations
  • Link to evidence

Detail: references/stages/input.md


Stage 2: Hypothesis

File: 2-hypothesis.md Purpose: Link observation to Canvas assumption being tested.

Content:

  • Which assumption does this challenge/validate?
  • What do we believe will happen?
  • What would prove us wrong?
  • Testable prediction

Rules:

  • Must reference strategy/canvas/10.assumptions.md
  • State falsifiable hypothesis
  • Define success/failure criteria

Detail: references/stages/hypothesis.md


Stage 3: Implication

File: 3-implication.md Purpose: Analyze business impact with numbers.

Content:

  • Revenue impact (quantified)
  • Timeline (short/medium/long)
  • Resource requirements
  • Risk assessment
  • Opportunity cost

Rules:

  • Include specific numbers
  • Compare scenarios
  • Identify dependencies

Detail: references/stages/implication.md


Stage 4: Decision

File: 4-decision.md Purpose: Make official commitment with impact score.

Content:

  • Decision statement (PROCEED/DEFER/DECLINE)
  • Alternatives considered
  • Impact score calculation
  • Approval status

Impact Scoring:

Score Action
< 0.8 Auto-execute
≥ 0.8 Flag for human approval

Mode-Aware Formulas:

VENTURE: Impact = (Strategic Value × Market Size × Defensibility) / 3 BOOTSTRAP: Impact = (Revenue Impact × Time to Cash × Margin) / 3

Check strategy/canvas/00-business-model-mode.md for mode.

Detail: references/stages/decision.md


Stage 5: Actions

File: 5-actions.md or 5-actions/ directory Purpose: Generate executable tasks.

Content:

  • Typed actions (sales:, marketing:, engineering:*)
  • Assigned owners
  • Deadlines
  • Success criteria
  • Dependencies

Action Types by Thread:

Thread Action Types Skills
Sales lead-intake, qualify, demo, pilot, close sales-*
Marketing research, create, publish, promote, measure marketing-*
Engineering requirements, specification, implementation engineering-*
Business varies by decision -

Detail: references/stages/actions.md


Stage 6: Learning

File: 6-learning.md Purpose: Document outcomes and update Canvas + Goal.

Content:

  • Actual vs expected outcome
  • Hypothesis validated/invalidated?
  • Canvas sections to update
  • Goal metrics to update (if goal-linked)
  • New threads generated

Rules:

  • Update strategy/canvas/10.assumptions.md
  • Link learning to original hypothesis
  • If goal-linked: Update goal state via goal-tracker
  • Generate follow-up threads if needed

Goal Integration:

If thread.goal_id exists:
  1. Read goal from strategy/goals/active/{goal_id}.md
  2. Update subgoal status (pending → completed)
  3. Extract metrics from learning for goal state
  4. Check if goal success criteria met
  5. If all subgoals complete → mark goal completed

Detail: references/stages/learning.md


Workflow

Goal-Linked Thread (Primary)

1. Receive subgoal from goal-setter
2. Create thread: threads/{type}/{name}/
3. Set meta.json with goal_id and subgoal
4. Execute stages 1-6 sequentially
5. At Stage 4: Calculate impact, flag if ≥0.8
6. At Stage 6: Update Canvas AND goal state
7. Notify goal-tracker of completion

Reactive Thread (Fallback)

1. Receive signal (feedback, anomaly, opportunity)
2. Create thread: threads/{type}/{name}/
3. Set meta.json without goal_id
4. Execute stages 1-6 sequentially
5. At Stage 4: Calculate impact, flag if ≥0.8
6. At Stage 6: Update Canvas
7. Optionally: Link to existing goal or spawn new goal

Thread Structure

threads/{type}/{name}/
├── meta.json           # Thread metadata (includes goal linkage)
├── 1-input.md          # Factual observation
├── 2-hypothesis.md     # Canvas assumption link
├── 3-implication.md    # Impact analysis
├── 4-decision.md       # Commitment + impact score
├── 5-actions.md        # Executable tasks
└── 6-learning.md       # Outcomes + Canvas/Goal update

Thread Metadata (meta.json)

{
  "id": "thread-{type}-{name}",
  "type": "business | sales | marketing | engineering",
  "status": "active | completed | blocked",
  "created": "YYYY-MM-DD",
  "updated": "YYYY-MM-DD",
  "goal_id": "g-{goal-id}",        // Optional: linked goal
  "subgoal": "SG1",                 // Optional: which subgoal
  "stage": 1-6,
  "impact_score": 0.0-1.0
}

Goal-linked threads:

  • goal_id references strategy/goals/active/{goal-id}.md
  • subgoal indicates which subgoal this thread executes
  • Stage 6 learning updates both Canvas AND goal state

Reactive threads (no goal):

  • goal_id is null or absent
  • At completion, may link to existing goal or spawn new goal

Decision Authority

AI Autonomous (Impact <0.8):

  • Within strategic direction
  • ROI > 3x, risk low-medium
  • Cost <$100K, timeline <3 months

Human Review (Impact ≥0.8):

  • Strategic pivot
  • ROI <2x, high risk
  • Cost ≥$100K, timeline ≥3 months
  • Canvas-altering decisions

References

references/
├── stages/           # Stage execution details
│   ├── input.md
│   ├── hypothesis.md
│   ├── implication.md
│   ├── decision.md
│   ├── actions.md
│   └── learning.md
└── threads/          # Thread type specifics
    ├── operations.md
    ├── sales.md
    ├── marketing.md
    └── engineering.md

Note: Action execution uses flat skills (sales-*, marketing-*, engineering-*) not templates.

Success Criteria

  • Goal-aligned: Thread serves a goal subgoal (when goal-linked)
  • Evidence-based: Starts with factual observation
  • Hypothesis-driven: Links to Canvas assumptions
  • Impact-analyzed: Quantified cost/benefit
  • Traceable: Complete 6-stage audit trail
  • Self-correcting: Canvas AND goal updates from learning
  • Autonomous: AI executes >95% (impact <0.8)

Remember

Every decision flows through 6 stages. No shortcuts.

Goals are primary. Threads execute goals. Reactive threads are fallback.

This skill:

  • Executes the 6-stage causal flow
  • Links threads to goals (when goal-linked)
  • Reads reference docs for detail
  • Calculates impact scores
  • Updates Canvas AND goal state from learning
  • Flags high-impact items for human review

Related Skills

Attack Tree Construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

skill

Grafana Dashboards

Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.

skill

Matplotlib

Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.

skill

Scientific Visualization

Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.

skill

Seaborn

Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.

skill

Shap

Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Query Writing

For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Scientific Visualization

Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.

skill

Skill Information

Category:Skill
Last Updated:1/13/2026