descriptive-evidence

Produces validated descriptive statistics, trends, and stylized facts from empirical datasets.

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/lancegui/causal-powers --skill descriptive-evidence-lancegui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: descriptive-evidence
Source: https://github.com/lancegui/causal-powers/tree/main/skills/descriptive-evidence
Command: npx skills add https://github.com/lancegui/causal-powers --skill descriptive-evidence-lancegui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Descriptive statistics often look clean while hiding silent errors: composition shifts, missing deflation, wrong denominators, or heavy-tailed means that describe no one. This Skill applies a rigorous discipline to descriptive work so trends, Table 1 summaries, and stylized facts survive composition checks, robustness re-cuts, and external plausibility anchors before they reach a paper or deck. ## Core Features & Use Cases - Comparability enforcement: Fixes denominator, deflation base year, per-capita scaling, weighting, unit of observation, window, and aggregation level before any plot is made. - Composition checking: Decomposes aggregate changes into within-group vs. mix effects (shift-share, Oaxaca, subgroup plots) to catch Simpson's paradox and selection artifacts. - Robustness and validity gates: Re-cuts reported facts across alternative specifications and triangulates levels against external benchmarks or known shocks. - Causal firewall: Enforces descriptive verbs only, routing causal questions to the appropriate identification workflow. - Use Case: You have a hospital panel from 2008-2022 and want a chart of average charges over time. The Skill deflates to constant dollars, checks whether hospital entry/exit drives the trend, reports medians alongside means for the heavy-tailed charge variable, and keeps the write-up descriptive. ## Quick Start Ask the assistant to show the trend in a variable, build a Table 1 by group, or produce stylized facts from your dataset, and it will apply the comparability, composition, and robustness checks before delivering the exhibit.

Frequently Asked Questions about descriptive-evidence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a Table 1 summary statistics table in R or Python?▼

Use gtsummary or modelsummary in R, or tableone and pandas.describe in Python, with sample size, unit of observation, and survey weighting stated explicitly. Report medians and percentiles for heavy-tailed variables like income rather than means alone.

How do I check if a trend is a composition effect or Simpson's paradox?▼

Decompose the aggregate change into within-group and between-group (mix) components using shift-share or Oaxaca-style decompositions, and plot the subgroups directly. If the aggregate moves only because group weights shifted, the honest statement is about the mix, not the level.

Should I deflate dollar values before plotting a time trend?▼

Yes, any dollar figure compared across time must be deflated to a stated base year using a named deflator such as CPI or PCE, otherwise part of the apparent growth is inflation. Annotate the choice in code so it remains recoverable later.

Why is reporting only the mean misleading for income or firm size data?▼

Economic variables are heavy-tailed, so a mean can describe no actual observation and can move because of a single tail value. Report the median, key percentiles, spread, and the distribution shape, and use a log scale for multiplicative quantities.

When should descriptive analysis not use causal language?▼

Descriptive exhibits show co-movement and differences, never causes, so verbs like raised, drove, or the effect of are off-limits. A striking stylized fact should motivate a causal question that is then answered with a proper identification design.

What are the limits of a choropleth map for descriptive evidence?▼

Maps shaded by raw counts mostly show where population lives, so normalize to rates or per-capita values. The spatial unit choice and color binning scheme change the visual story, and point-in-polygon joins can silently drop features, so joins need explicit validation.