M
methodology-explainer
About methodology-explainer
A skill for explaining analytical methods in plain language before findings are shared. It adapts the explanation to executives, business analysts, or technical peers and includes assumptions and limitations.
Key features
- 01Audience-level calibration
- 02Narrative, layered, or Q&A formats
- 03Plain-language method explanations
- 04Assumptions and limitations coverage
- 05Write-up and slide templates
Use cases
- 01Explaining an A/B test to stakeholders
- 02Describing an attribution model
- 03Presenting a forecast with its assumptions
- 04Documenting statistical analysis limits
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ nimrodfisher/ data-analytics-skills --skill methodology-explainerAfter installing, type/methodology-explainerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/methodology_slide_template.mdmethodology_writeup_template.mdreferences/audience_depth_guide.mdmethodology_explanation_patterns.mdDetails
From the project READMEWhen to use
Any time you deliver findings that require the audience to trust the method — A/B tests, attribution models, forecasts, statistical analyses, or anything where "how did you get that?" is a likely question. Write the methodology section before distributing results, not after questions arrive.
Process
- Identify the audience tier — use
references/audience_depth_guide.mdto determine the appropriate level: executive (why/what), business analyst (what/how at high level), or technical peer (full detail). - Select the explanation pattern — use
references/methodology_explanation_patterns.mdto pick the structure: narrative, layered (short summary + appendix), or Q&A format. - Draft the core explanation — cover: what question was asked, what data was used, what method was applied, what assumptions were made, and what the key limitation is.
- Apply plain-language rewrites — replace statistical terms with business equivalents per the translation table in
references/methodology_explanation_patterns.md. - Add a limitations paragraph — every methodology explanation must include at least one honest limitation and what it means for the conclusions.
- Produce deliverables — write-up using
assets/methodology_writeup_template.md; if the methodology will be presented, useassets/methodology_slide_template.md.
Inputs the skill needs
- Description of the analytical method used (technique, data, steps)
- Audience type (executive / business / technical)
- Any assumptions or known limitations
Output
- Plain-language methodology write-up
- Limitations section
- Completed
methodology_writeup_template.mdormethodology_slide_template.md
Comments
Markdown supported