Claude-skill-registry-data methods-writer

Draft publication-ready Methods sections for interview-based sociology articles. Guides pathway selection, component coverage, and calibration based on analysis of 77 Social Problems/Social Forces articles.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry-data
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/methods-writer" ~/.claude/skills/majiayu000-claude-skill-registry-data-methods-writer && rm -rf "$T"
manifest: data/methods-writer/SKILL.md
source content

Methods Writer

You help sociologists write Methods sections (also called "Data and Methods" or "Methodology" sections) for interview-based journal articles. Your guidance is grounded in systematic analysis of 77 articles from Social Problems and Social Forces.

When to Use This Skill

Use this skill when users want to:

  • Draft a new Methods section from scratch
  • Restructure an existing Methods section that's too long or too short
  • Determine the appropriate level of detail for their study
  • Ensure all required components are included
  • Calibrate their section to field norms

This skill assumes users have completed their data collection and analysis, and are ready to write up their methods.

Connection to Other Skills

SkillPurposeKey Output
interview-analystAnalyze qualitative dataCoding structure, findings
interview-writeupWrite findings sectionsDraft findings
interview-bookendsWrite intros/conclusionsDraft bookends

Core Principles (from Genre Analysis)

Based on systematic analysis of 77 Methods sections:

1. Study-Led Openings Dominate

88% of methods sections open with the study or sample, not with methodological justification. Lead with your data, not your rationale for using interviews.

2. Saturation Claims Are Rare

Only 4% of articles claim saturation. The field has largely moved beyond this justification. Use alternatives: comparative adequacy, coverage sufficiency, or pragmatic bounds.

3. Tables Correlate with Complexity

54% of articles include a demographic table. Use tables when sample composition matters for interpretation or when N > 30. Efficient pathway articles skip tables entirely.

4. Positionality Is Conditional

Only 17% include positionality discussions. Include when: interviewer-respondent identity mismatch is notable, you studied vulnerable populations, or identity shaped access/disclosure.

5. Three Pathways Cover the Field

Articles cluster into Efficient (10%), Standard (61%), and Detailed (23%) pathways based on word count and structural complexity. Match your pathway to your study characteristics, not your preferences.

Key Statistics (Benchmarks)

Methods Section Benchmarks

FeatureMedianIQR (Typical Range)
Word count1,3611,001-2,032
Has table54%--
Subsections67% none0-2
Positionality17%--
Saturation mentioned4%--

Word Count Distribution

RangeLabelPrevalence
< 700Efficient10%
700-2,000Standard61%
2,000-3,500Detailed23%
> 3,500Extended*6%

*Extended articles are typically multi-study or exceptionally complex designs.

The Three Pathways

Methods sections cluster into three recognizable styles based on length, structure, and documentation level:

PathwayTarget WordsPrevalenceKey FeatureWhen to Use
Efficient600-90010%Compressed, no tableSimple design, space constraints
Standard1,200-1,50061%Balanced, table optionalTypical interview study (DEFAULT)
Detailed2,000-3,00023%Comprehensive, table requiredVulnerable population, complex design

Default: Standard pathway. Choose Efficient or Detailed only when specific triggers apply.

See

pathways/
directory for detailed profiles with benchmarks, signature moves, and word allocation guides.

Workflow Phases

Phase 0: Assessment

Goal: Gather study information and select the appropriate pathway.

Process:

  • Collect study details (sample, population, design, access)
  • Apply decision tree to identify pathway
  • Confirm pathway selection with user
  • Note any special considerations (vulnerability, complexity)

Output: Pathway selection memo with rationale.

Pause: User confirms pathway selection before drafting.


Phase 1: Drafting

Goal: Write the complete Methods section following pathway template.

Process:

  • Follow pathway-specific structure and word allocation
  • Include all required components for the pathway
  • Use appropriate rhetorical patterns from corpus
  • Integrate optional components based on user's study

Guides:

  • phases/phase1-drafting.md
    (main workflow)
  • pathways/
    (pathway-specific templates)
  • techniques/component-checklist.md
    (what to include)
  • techniques/opening-moves.md
    (how to start)

Output: Complete Methods section draft.

Pause: User reviews draft.


Phase 2: Revision

Goal: Calibrate against benchmarks and polish.

Process:

  • Verify word count against pathway target
  • Check all required components are present
  • Assess optional components (positionality, limitations)
  • Polish prose and transitions
  • Final quality check

Guide:

phases/phase2-revision.md

Output: Revised Methods section with quality memo.


Pathway Decision Tree

To identify which pathway fits your study:

START
  |
  v
[Is your population VULNERABLE or MARGINALIZED?]
  |
  +-- YES --> DETAILED PATHWAY
  |
  +-- NO --> Continue
        |
        v
[Is your design COMPLEX?]
(Multi-site, comparative, longitudinal, 100+ interviews)
  |
  +-- YES --> DETAILED PATHWAY
  |
  +-- NO --> Continue
        |
        v
[Are there SPACE CONSTRAINTS or is methods SECONDARY?]
  |
  +-- YES --> EFFICIENT PATHWAY
  |
  +-- NO --> STANDARD PATHWAY (DEFAULT)

Quick Indicators

If you have...Consider this pathway...
Vulnerable population (incarcerated, undocumented)Detailed
Multi-site or comparative designDetailed
100+ interviewsDetailed
Significant access challengesDetailed
Severe word limitsEfficient
Simple convenience/snowball sampleEfficient
Typical single-site, 30-80 interviewsStandard

Pathway Profiles

Reference these guides for pathway-specific writing:

GuidePathway
pathways/efficient.md
Efficient (10%) - 600-900 words
pathways/standard.md
Standard (61%) - 1,200-1,500 words
pathways/detailed.md
Detailed (23%) - 2,000-3,000 words

Technique Guides

GuidePurpose
techniques/component-checklist.md
What to include for each component (sampling, protocol, analysis)
techniques/opening-moves.md
How to open methods sections (study-led patterns)

Required vs. Optional Components by Pathway

ComponentEfficientStandardDetailed
Sample NRequiredRequiredRequired
DemographicsBrief proseProse + tableTable + comparison
RecruitmentNamedNamed + channelsChannels + rates
DurationRequiredRequiredRequired + median
Analysis approachNamedNamed + processNamed + codes
SoftwareOptionalRecommendedRequired
PositionalityOmitConditionalEncouraged
Ethical protectionsBriefAs neededDetailed if vulnerable

Model Recommendations

PhaseModelRationale
Phase 0: AssessmentSonnetDecision tree application
Phase 1: DraftingSonnetFollowing templates, prose generation
Phase 2: RevisionSonnetCalibration checking, polish

Starting the Process

When the user is ready to begin:

  1. Ask about the study:

    "What is your study about? Please describe your sample (N, population), how you recruited participants, your interview approach, and how you analyzed the data."

  2. Ask about study characteristics:

    "Is your population vulnerable or marginalized? Is your design complex (multi-site, comparative, longitudinal, 100+ interviews)? Are there space constraints or journal word limits?"

  3. Identify pathway:

    Based on your answers, apply the decision tree and recommend a pathway with rationale.

  4. Confirm and proceed to Phase 0 to formalize the assessment.

Key Reminders

  • Standard is the default: Most interview studies fit the Standard pathway. Choose Efficient or Detailed only when triggers apply.
  • Saturation is rare: Only 4% of corpus articles claim saturation. Use alternatives: "continued until key themes emerged across subgroups" or "sample size reflects [comparative/coverage/pragmatic] considerations."
  • Tables save words: A demographic table can replace 200+ words of prose. Use tables when N > 30 or composition matters.
  • Positionality is conditional: Only 17% include it. Triggers: identity mismatch, vulnerable population, identity shaped access.
  • Study-led openings: 88% open with the study/sample. Start with "I/We draw from N interviews with [population]" not "Qualitative methods are appropriate because..."
  • Word counts matter: Reviewers notice methods sections that are too thin or bloated. Match your pathway.