interview-writeup

📁 nealcaren/social-data-analysis 📅 Jan 29, 2026
4
总安装量
2
周安装量
#53991
全站排名
安装命令
npx skills add https://github.com/nealcaren/social-data-analysis --skill interview-writeup

Agent 安装分布

codex 2
claude-code 2
gemini-cli 2
trae 1
opencode 1

Skill 文档

Interview Write-Up

You help sociologists write up qualitative interview research for journal articles and reports. Your role is to guide users through methods drafting, findings construction, and evidence presentation with clear standards for rigor and narrative craft.

Connection to interview-analyst

This skill pairs with interview-analyst as a one-two punch:

Skill Purpose Key Output
interview-analyst Analyzes interview data, builds codes, identifies patterns quote-database.md with quotes organized by finding, anchors/echoes identified
interview-writeup Drafts methods and findings sections Publication-ready prose

If users ran interview-analyst first, request their quote-database.md and participant-profiles/ folder—these are designed to feed directly into writeup.

When to Use This Skill

Use this skill when users want to:

  • Draft or revise a methods section for interview-based research
  • Structure a findings section and present qualitative evidence
  • Improve quote selection, integration, and analytical framing
  • Transform a theme-catalog draft into argument-driven narrative

Core Principles

  1. Argument, not display: Findings sections advance analytic claims; quotes instantiate ideas already introduced by the author.
  2. Claims precede quotes: Readers should know what to listen for before the quote arrives.
  3. Anchor and echo: Go deep on one exemplary case, then zoom out to show prevalence.
  4. Variation is data: Exceptions and contradictions are analytically valuable—but establish baseline first.
  5. Brevity serves clarity: Include as much evidence as necessary and no more. If one quote will do, don’t use three.
  6. Mechanism naming: Findings should clarify how processes work, not just what happens.

Quality Indicators

Evaluate writing against these markers:

  • Analytical confidence: Patterns stated assertively; mechanisms named by the author, not discovered in quotes
  • Narrative craft: Varied quote integration; anchor-echo pacing; smooth transitions
  • Grounded abstraction: Sociological concepts tied to concrete, specific evidence
  • Strategic depth: Anchor cases developed fully; echoes efficient
  • Appropriate scope: Claims bounded to sample; prevalence indicated throughout

Technique Guides

The skill includes detailed reference guides:

Guide Purpose
techniques/macro-structure.md Choosing archetypes (Mechanism List, Comparative, Process); Roadmap + Pillars model; section organization
techniques/prose-craft.md Quote integration techniques; Anchor-Echo pattern; pacing; attribution; transitions
techniques/rubric.md The 8-step process for drafting each subsection
techniques/participant-management.md Minimizing recurrence; recall tags; when participants should (and shouldn’t) reappear

Workflow Phases

Phase 0: Intake & Scope

Goal: Confirm required inputs and define the writing task.

  • Gather required materials (participant table, quotes, main argument)
  • Clarify whether the user needs methods, findings, or both
  • Identify the main argument and 3-4 core findings

Guide: phases/phase0-intake.md

Pause: Confirm scope and inputs before drafting.


Phase 1: Methods Section

Goal: Draft or revise a transparent, defensible methods section.

  • Case selection, sampling, recruitment, sample size justification
  • Interview protocol and analysis approach
  • Positionality (when appropriate)

Guide: phases/phase1-methods.md

Pause: Review the methods draft for completeness and clarity.


Phase 2: Findings Section

Goal: Structure findings as argument-driven narrative.

  • Choose an archetype (Mechanism List, Comparative, or Process)
  • Write the Roadmap introduction summarizing the entire argument
  • Draft each subsection following the 8-step rubric
  • Use the Anchor-Echo pattern for evidence presentation
  • Craft theoretical headings that name mechanisms

Guides:

  • phases/phase2-findings.md (main workflow)
  • techniques/macro-structure.md (organization)
  • techniques/prose-craft.md (quote integration)
  • techniques/rubric.md (subsection drafting)

Pause: Confirm findings structure and evidence selection.


Phase 3: Revision & Quality Check

Goal: Transform competent draft into compelling argument.

  • Check argument structure (roadmap, claims before quotes)
  • Verify Anchor-Echo pattern in each subsection
  • Fix formulaic quote integration
  • Ensure appropriate voice balance and confidence
  • Catch prohibited moves

Guide: phases/phase3-revision.md


Prohibited Moves

The skill explicitly trains against common problems:

  • Starting subsections with quotes
  • Listing themes without argument
  • Using quotes without interpretation
  • Stacking quotes back-to-back
  • Hedging empirical patterns (“might suggest”)
  • Writing descriptive subheadings (“Findings,” “Race”)
  • Letting quotes introduce analytic novelty
  • Treating all quotes with equal depth (no anchor)
  • Starting with variation before baseline

Output Expectations

Provide the user with:

  • A draft or revised methods section (if requested)
  • A structured findings section following the chosen archetype
  • A quality check memo assessing strengths, gaps, and remaining issues

Invoking Phase Agents

Use the Task tool for each phase:

Task: Phase 2 Findings Drafting
subagent_type: general-purpose
model: opus
prompt: Read phases/phase2-findings.md and the technique guides, then draft the findings section for the user's [project description]. Follow the 8-step rubric for each subsection. Use the Anchor-Echo pattern.

Model recommendations:

  • Phase 0-1 (intake, methods): Sonnet
  • Phase 2 (findings): Opus (requires narrative craft)
  • Phase 3 (revision): Opus (requires editorial judgment)