mcpField
M
methodology-explainer

methodology-explainer

github.com/nimrodfisherData & databases504217 installsUpdated 5w ago
Repository

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

  1. 01Audience-level calibration
  2. 02Narrative, layered, or Q&A formats
  3. 03Plain-language method explanations
  4. 04Assumptions and limitations coverage
  5. 05Write-up and slide templates

Use cases

  1. 01Explaining an A/B test to stakeholders
  2. 02Describing an attribution model
  3. 03Presenting a forecast with its assumptions
  4. 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-explainer

After installing, type/methodology-explainerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
methodology_slide_template.md
methodology_writeup_template.md
references/
audience_depth_guide.md
methodology_explanation_patterns.md

Details

From the project README

When 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

  1. Identify the audience tier — use references/audience_depth_guide.md to determine the appropriate level: executive (why/what), business analyst (what/how at high level), or technical peer (full detail).
  2. Select the explanation pattern — use references/methodology_explanation_patterns.md to pick the structure: narrative, layered (short summary + appendix), or Q&A format.
  3. 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.
  4. Apply plain-language rewrites — replace statistical terms with business equivalents per the translation table in references/methodology_explanation_patterns.md.
  5. Add a limitations paragraph — every methodology explanation must include at least one honest limitation and what it means for the conclusions.
  6. Produce deliverables — write-up using assets/methodology_writeup_template.md; if the methodology will be presented, use assets/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.md or methodology_slide_template.md

Comments

Markdown supported