methods-section

Extracts tool versions and provenance from lockfiles to draft academic Methods sections.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/ppavlidis/skillz --skill methods-section-ppavlidis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: methods-section
Source: https://github.com/ppavlidis/skillz/tree/main/skills/methods-section
Command: npx skills add https://github.com/ppavlidis/skillz --skill methods-section-ppavlidis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Writing an accurate Methods section requires manually tracking which tools, versions, data sources, and parameters were used in an analysis — information that is easy to forget or reconstruct incorrectly. This Skill automates the mechanical extraction of that information from lockfiles and provenance sidecars so the Methods paragraph is grounded in the actual analysis. ## Core Features & Use Cases - Lockfile scanning: Parses requirements.txt, renv.lock, conda environment.yaml, and pyproject.toml to extract tool names, versions, and package sources (PyPI, CRAN, Bioconductor, conda). - Provenance extraction: Reads *.meta.json sidecars to surface sha256 hashes, download dates, source URLs, DOIs, and data versions for each artifact. - Workflow and runtime detection: Finds Snakemake, Nextflow, WDL, and CWL workflow files plus R and Python runtime versions. - Use Case: After finishing a differential expression analysis, run the scanner on the project directory and ask Claude to draft the Methods paragraph — it produces text citing DESeq2 v1.40.2 in R 4.3.2, the GOA download date, and the DOI, ready for the manuscript. ## Quick Start Ask Claude to draft a Methods section for your analysis directory, and it will run scripts/scan.py on that directory and write the paragraph from the resulting JSON.

Frequently Asked Questions about methods-section

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

FAQPage Schema
How do I generate a Methods section from my analysis directory?

Run scripts/scan.py on your analysis directory to produce JSON listing tools, versions, artifacts, and workflows. Claude then reads that JSON and drafts a Methods paragraph with citations, DOIs, and download dates in standard academic style.

What lockfiles does the Methods section scanner support?

The scanner parses requirements.txt, renv.lock, conda environment.yml/yaml, and pyproject.toml. It extracts package names, versions, and sources such as PyPI, CRAN, Bioconductor, and conda, plus R and Python runtime versions.

Does the scanner require any Python packages to run?

No, scan.py uses only the Python 3.9+ standard library with no external dependencies. All parsing is done with regex and the json module, so it runs in any environment without installation.

What information can the scanner not find automatically?

It cannot detect custom unpublished scripts, system-wide tools like samtools installed outside a conda env, R packages loaded without renv, or database access dates not recorded in a .meta.json sidecar. These must be mentioned manually.

How does methods-section work with provenance-stamp?

The provenance-stamp skill writes *.meta.json sidecars recording sha256, source URL, DOI, and fetch dates for each data artifact. methods-section reads those sidecars to build the data-sources list with download dates and DOIs automatically.