agentleFS
fabioc-alohafabioc-aloha/Alex_ACT_ONE/skills/chart-interpretation/SKILL.md

chart-interpretation

Skill0 starsChanged 9 days agoMITView on GitHub

Read a chart someone else made — image, screenshot, HTML, or dashboard — and extract insights, patterns, anomalies, and misleading framing. The reverse of authoring. Use when handed a chart to analyze, when checking whether a chart's visuals support its claim, or when a figure needs a written narrative.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check every chart for these deceptive patterns:

    line 72
  2. Distinctive:

    Always read these elements before interpreting the data:

    line 88
  3. Distinctive:

    After interpreting, suggest what would strengthen the analysis:

    line 153
  4. Very specific:

    Use the CSAR loop from chart-vocabulary Module 2 for structured chart reading:

    line 165

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Chart Interpretation

The reverse of chart authoring. Instead of data to chart, this reads chart to insight to narrative. It works on charts you did not make: screenshots, images, HTML, dashboard exports.

The cardinal rule: read what the chart says, then read what it doesn't say. The visible data points tell one story; the missing context, truncated axes, and suppressed categories tell another.

Composes with chart-vocabulary for chart-type knowledge and critical-thinking for the evidence-quality and bias checks that Module 4 applies to visuals.

Module 1: Chart Type Recognition

Identify the chart type to determine the correct reading strategy.

Chart TypeKey Visual FeaturesReading Strategy
Bar / ColumnRectangular bars, one axis categoricalCompare bar lengths, check sort order
Horizontal BarBars extend left-to-rightRank comparison, read labels first
LineConnected points over axisFollow trend direction, find inflections
AreaFilled region under lineVolume over time, stacking if multiple
Pie / DonutCircular segmentsPart-to-whole, count segments, check %
ScatterPoints in x-y spaceLook for clusters, outliers, trend line
BubbleScatter with size encodingThree dimensions: x, y, size
HistogramBars touching, x is continuousDistribution shape, skew, outliers
HeatmapColor gridPattern density, row-column relationships
TreemapNested rectanglesHierarchical proportions
SankeyFlow ribbons between stagesVolume flow, biggest paths
Box PlotBox + whiskersMedian, IQR, outlier dots
NetworkNodes + edgesClusters, hubs, isolates
ViolinMirrored density curvesDistribution shape + density

Module 2: Visual Decoding

Extract data from visual encodings:

EncodingWhat to ReadPrecision Level
Position (axis)Exact values from gridlines/labelsHigh (if labeled)
Length (bar)Relative magnitude between itemsHigh
Color hueCategory membershipCategorical only
Color intensityValue magnitude in sequential schemeMedium
Size (area)Third variable (bubble, treemap)Low (area perception is poor)
Angle (pie)Proportion (poor human accuracy)Low
Slope (line)Rate of changeMedium

Module 3: Pattern Detection

PatternWhat to Look ForSignificance
TrendConsistent upward/downward directionGrowth, decline, momentum
InflectionDirection change pointMarket shift, intervention effect
PlateauFlat region after growth/declineSaturation, stabilization
ClusterGroups of points in scatter/networkNatural segments, sub-populations
OutlierPoints far from the main groupAnomaly, error, or special case
PeriodicityRepeating pattern at intervalsSeasonality, weekly cycle
GapMissing data or discontinuityData quality issue or deliberate omission
SkewAsymmetric distribution shapeNon-normal population, concentration
DominanceOne item >> all othersPower law, market leader, outlier

Module 4: Misleading Visual Detection

Check every chart for these deceptive patterns:

DeceptionHow to DetectActual Impact
Non-zero baselineY-axis starts above 0Exaggerates differences (sometimes 2-5x)
Truncated axisAxis range excludes data or starts mid-rangeHides context, magnifies small changes
Dual axesTwo Y-axes with different scalesImplies correlation where none may exist
3D effectsPerspective distortion on bars/piesArea comparison becomes inaccurate
Cherry-picked rangeTime window starts/ends at convenient pointHides contrary trend outside window
Suppressed categories"Other" aggregates significant itemsHides important segments
Area distortionVariable-width bars, non-proportional iconsSize doesn't match value
Missing denominatorPercentages without base size50% of 10 ≠ 50% of 10,000
Reversed axisValues increase downward or rightwardReaders misread direction

Module 5: Structural Element Reading

Always read these elements before interpreting the data:

ElementWhat to ExtractIf Missing
TitleAuthor's intended takeawayChart lacks stated purpose
SubtitleTime range, filter condition, contextContext must be inferred
Axes labelsWhat variables are plottedInterpretation becomes guesswork
LegendCategory-to-color mappingColor meaning unclear
AnnotationsAuthor-highlighted insightsNo guided reading
Data sourceWhere the data came fromCredibility unknown
Date/timeWhen data was collected/reportedFreshness unknown

Module 6: Narrative Extraction

Convert visual observations into prose at three audience levels:

Executive Summary (30 seconds)

3 bullets maximum:
• [Primary insight — the main takeaway]  
• [Supporting evidence — the strongest proof point]  
• [Recommendation or implication — what to do about it]

Detailed Analysis (2-3 minutes)

The chart shows [chart type] plotting [X variable] against [Y variable]
for [time range / scope].

Primary finding: [Main pattern or insight with specific numbers]

Supporting observations:
- [Pattern 1 with evidence]
- [Pattern 2 with evidence]
- [Anomaly or exception worth noting]

Context and caveats:
- [What the chart doesn't show]
- [Potential biases or limitations]
- [Comparison to benchmarks if available]

Talking Points (presenter-ready)

"What you're seeing here is [explain the main pattern in plain language]."
"The key number to focus on is [highlight], which tells us [implication]."
"What's interesting is [surprise or anomaly] — this suggests [hypothesis]."
"The action item here is [recommendation]."

Module 7: Confidence Rating

Rate interpretation confidence honestly:

LevelWhenSignal to User
HighClear labels, clean data, familiar chart type"The chart clearly shows..."
MediumSome inference needed (unlabeled, partial data)"Based on visual estimation..."
LowAmbiguous visual, missing context, blurry image"This appears to show, but verify..."

Module 8: Follow-Up Recommendations

After interpreting, suggest what would strengthen the analysis:

Suggestion TypeExample
Missing variable"Add cost data to see if revenue growth is profitable"
Time extension"Extend to 24 months to confirm the seasonal pattern"
Segmentation"Break this down by region to check for Simpson's Paradox"
Alternative chart"A scatter plot would better show the correlation"
Baseline addition"Add a target line to show performance vs. plan"

Module 9: CSAR Loop Integration

Use the CSAR loop from chart-vocabulary Module 2 for structured chart reading:

PhaseAction
ClarifyWhat chart type? What variables? What time range?
SummarizeState the main finding in one sentence
ActExtract specific data points, patterns, anomalies
ReflectWhat's missing? What would I want to see next?

Anti-Patterns

Anti-PatternProblemFix
Describing, not interpreting"This is a bar chart" (no insight)Say what the bars MEAN, not what they ARE
Ignoring the titleMissing the author's intended messageRead title first -- it's the thesis
Over-precision from visual"Revenue is exactly $4,237,892"Estimate from visual: "roughly $4.2M"
Missing bias checkAccepting the chart at face valueAlways scan for misleading elements
Single-lens readingOnly one interpretation offeredProvide primary + alternative reading

Related Skills

  • chart-vocabulary — chart types by communication goal, and the CSAR loop Module 9 uses
  • critical-thinking — Module 4's deception checks are evidence-quality and bias detection applied to a picture
  • flint-chart — the authoring direction. Read a chart here, make one there
  • render-verify — checks a chart you rendered says what you meant. This skill reads charts you did not make

Would Revise If

Revise if interpretations consistently state what a chart is rather than what it means, or if the confidence ratings in Module 7 prove uncalibrated against later verification of the underlying data.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.