Reasoning Causal
by aiskillstore
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_idin 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_idreferencesstrategy/goals/active/{goal-id}.mdsubgoalindicates which subgoal this thread executes- Stage 6 learning updates both Canvas AND goal state
Reactive threads (no goal):
goal_idis 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.
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.
Matplotlib
Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.
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.
Seaborn
Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.
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
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.
Query Writing
For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations
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.
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.
