agentleFS
khuynh22khuynh22/agent-dev-team/skills/data-analysis/SKILL.md

data-analysis

Skill9 starsChanged 2 months agoMITView on GitHub

Answers a question from data honestly: define the metric and its denominator up front, verify the data is fresh and complete, reconcile against a number somebody already trusts, segment before concluding, rule out the boring explanations, and ship the caveat alongside the number. Use when asked why signups, revenue, or conversion dropped last week, why a metric moved, what a number really means, or whether a dashboard can be believed.

76 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use algorithm-design, review-r and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • lingzhi227Skill

    algorithm-design

    Design algorithms with LaTeX pseudocode and UML diagrams. Generate algorithmic environments, Mermaid class/sequence diagrams, and ensure consistency between pseudocode and implementation. Use when formalizing methods for a paper.

    Also in 5 projects that use this

  • luischanciSkill

    review-r

    Run the R code review protocol on R scripts. Checks code quality, reproducibility, domain correctness, and professional standards. Produces a report without editing files.

    Also in 4 projects that use this

  • zephyrwang6Skill

    deepl

    Übersetzt Texte, Dokumente und XLIFF-Dateien via DeepL API. Verwende für Übersetzungen mit /deepl translate, /deepl file oder /deepl xliff.

    Also in 4 projects that use this

  • zephyrwang6Skill

    imagemagick-conversion

    Convert and manipulate images with ImageMagick. Covers format conversion, resizing, batch processing, quality adjustment, and image transformations. Use when user mentions image conversion, resizing images, ImageMagick, magick command, batch image processing, or thumbnail generation.

    Also in 4 projects that use this

  • lingzhi227Skill

    latex-formatting

    Handle LaTeX formatting, templates, and styling for academic papers. Set up conference templates (ICML, ICLR, NeurIPS, AAAI, ACL), fix formatting issues, manage packages, and ensure venue-specific compliance. Use when the user needs to set up a paper template, fix LaTeX formatting, or prepare for submission.

    Also in 4 projects that use this

  • stophobiaSkill

    surprise-me

    Create a delightful, unexpected "wow" experience for the user by dynamically discovering and creatively combining other enabled skills. Triggers when the user says "surprise me" or any request expressing a desire for an unexpected creative showcase. Also triggers when the user is bored, wants inspiration, or asks for "something interesting".

    Also in 4 projects that use this

  • +3 more from zephyrwang6
  • +2 more from lingzhi227

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 53 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check the guardrail metrics and the sample ratio before reading the headline number.

    line 59
  2. Distinctive:

    Every number traces to a saved, re-runnable query.

    line 79
  3. Distinctive:

    Every rate has its denominator stated, and every segment has its sample size.

    line 80
  4. Distinctive:

    No causal verb appears where the design does not support one.

    line 83

“Common” is measured: kept by at least 6 in 10 of the 53 edited versions of this file we could read. “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

Data Analysis

The number is the smallest part of the answer. The definition, the denominator, the sanity check, and the caveat are what make it safe for somebody to act on.

Standing reference: references/data-quality-checklist.md.

Process

  1. Restate the question and the decision behind it. "Did signups drop" and "should we roll back last night's release" need different analyses and different precision. Without the decision you cannot tell when the analysis is finished.
  2. Define the metric in writing before you query. Numerator, denominator, time grain, time zone, exclusions: internal accounts, bots, refunds, test records. Most disputed numbers are two people using one word for two definitions, discovered an hour into an argument.
  3. Verify the data before trusting it. Freshness for the period, row volume against the prior period, null rates on the columns you filter on. A pipeline gap is indistinguishable from a real drop until you check, and it is the more common cause.
  4. Reconcile against something already believed. Billing, the previous dashboard, a hand count for one day. Quote both numbers. An unreconciled number is a draft.
  5. Segment before concluding. A flat aggregate hides two populations moving in opposite directions, and the interesting finding is almost always inside a segment. Report sample size with every segment figure.
  6. Rule out the boring explanations, in this order: a data problem, seasonality or day of week, a release, a tracking or instrumentation change, one large account, reporting lag. Name which you tested and how, including the ones that survived.
  7. Separate correlation from cause, in the sentence itself. Observational comparisons between people who did and did not do something are selection effects until an experiment or a natural one says otherwise. Write "associated with", and say what would be needed to claim more.
  8. State the caveat with the number, not underneath it. Sample size, window sensitivity, what would change the conclusion. A finding that only holds for one window is a finding about the window.

Experiment readouts

  • The metric, the exposure definition, and the analysis window are fixed before looking.
  • Report the absolute effect and the interval, not only whether it cleared a threshold.
  • A non-significant result is a result. Report it as "no detectable effect above <n>", never as "no effect".
  • Check the guardrail metrics and the sample ratio before reading the headline number.

Output

## Question: <what was asked, and the decision it feeds>

- **Metric:** <numerator> / <denominator>, <grain>, timezone <tz>, excluding <list>
- **Answer:** <number, absolute and relative change, n>
- **Query:** `<path>` — source <table>, as of <date>
- **Data checks:** freshness <ok | stale>, volume vs prior <n>, nulls <n>
- **Reconciled against:** <trusted source> — <both numbers>
- **Segments:** <segment> <value> (n=<n>) ...
- **Ruled out:** <data | seasonality | release | tracking change | outlier account>
- **Caveats:** <sample size, window sensitivity, what this cannot show>
- **Confidence:** high | medium | low, and what would raise it

Verification

  • Every number traces to a saved, re-runnable query.
  • Every rate has its denominator stated, and every segment has its sample size.
  • The result reconciles against one independent source; both numbers are quoted.
  • At least one alternative explanation was tested and reported, including when it survived.
  • No causal verb appears where the design does not support one.

Red flags

ThoughtReality
"Signups dropped 30%"Over what base, over what window, and was the pipeline fresh?
"The correlation is strong"Strong correlation on observational data is still not a cause.
"This segment converts 4x better"With n=11. Sample size comes before the multiple.
"The number looks about right"Right against what? Reconcile it.
"I will start the chart in March"If the story needs March, the start date is the story.
"The dashboard says so"The dashboard has a definition. Read it before repeating it.
"The average is flat"Two populations moving opposite ways average to flat. Segment.
"Not significant, so no effect"It means no effect detectable at this sample size. Say that.

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.