科研 Skill
QualiGPT主题分析
qualigpt
Runs QualiGPT-style batch thematic analysis across interviews or documents, producing a theme table with quotes and source counts. Use for LLM-assisted thematic coding of a document batch.
SKILL.md
QualiGPT: LLM-Assisted Qualitative Thematic Analysis
This skill replicates the methodology of QualiGPT (Zhang et al., https://github.com/KindOPSTAR/QualiGPT — cite arXiv:2310.07061 and arXiv:2309.10771), a tool for LLM-assisted thematic analysis of qualitative data. The original tool sends structured prompts to an LLM; here, Claude performs the analysis directly using the same prompt structure, segmentation strategy, and output format.
Methodology overview
QualiGPT automates the coding step of qualitative analysis: identifying key themes in a dataset, describing them, and grounding each theme in verbatim quotes with a count of how many participants/sources support it. It follows this pipeline:
- Ingest data (.docx, .xlsx, .csv, .txt). For tabular data, expect a header row like
Speaker | Content. - Determine dataset type — interview, focus group, social media posts, or archival documents. Infer from context if obvious (e.g., the user says "these are my interview transcripts"); otherwise ask.
- Specify number of themes N (QualiGPT default: 10, range 1–20). Ask the user or default to 10.
- Ask the user to choose coding mode before analyzing, unless they've already made it clear: inductive (themes emerge from data — default if they have no codebook or don't state a preference) or deductive (they supply a codebook; themes must map to it). Skip the question only if the user has already handed you a codebook, named specific themes to code for, or otherwise unambiguously signaled deductive intent — don't ask a redundant question, but don't silently assume inductive when a codebook or a preference is on the table.
- Segment if the corpus exceeds the context that can be carefully analyzed in one pass (original: ~3,800 tokens per segment, split on sentence boundaries, never mid-sentence). Analyze each segment separately.
- Consolidate: if multiple segments were analyzed, merge all segment-level theme tables and re-analyze the merged responses to produce one final consolidated theme table (deduplicate overlapping themes, re-tally counts).
- Export results as .csv (parse the pipe-delimited table) and a human-readable report.
Analysis prompt (apply this to each segment)
Act as an experienced qualitative researcher. Apply this instruction pattern, adapted from QualiGPT verbatim:
You need to analyze a dataset of {interviews | a focus group | Social Media Posts | archival documents}. Please identify the top {N} key themes from the data and organize the results in a structured table. The table must have exactly 4 columns: Theme, Description, Quotes, and Participant Count (for documents: Source Count — number of distinct documents supporting the theme). Use
|to separate columns, include a header separator row|---|---|---|---|, and end the table with a line of**********before and after so it can be parsed.
Rules for faithful application:
- Quotes must be verbatim from the source text — never paraphrase inside the Quotes column. Include 1–3 short representative quotes per theme, each attributed to its source document/speaker.
- Counts must be real tallies — count the distinct participants/sources that evidence the theme; do not estimate.
- Themes should be distinct (minimal overlap), descriptive, and ranked roughly by prevalence.
- For deductive coding, only use themes from the user's codebook; note codebook themes with no supporting data.
Batch workflow for multiple files
- Convert every file to plain text (e.g.,
textutil -convert txtfor .docx on macOS; pandas for .xlsx/.csv). Keep a file → source ID mapping. - Read every document in full. Prepend each document's text with a source marker like
[SOURCE: doc_id]so quotes can be attributed. - If the total corpus is small enough to analyze carefully in one pass (roughly < 8,000 words), analyze the whole corpus at once. Otherwise segment per the rules above, analyze each segment, then run the consolidation pass.
- Produce three deliverables in an output folder next to the source files (e.g.,
qualigpt_output/):themes.csv— the final theme table parsed into CSV (columns: Theme, Description, Quotes, Source Count, Source IDs)analysis_report.md— the formatted theme table plus a short narrative summary, methodology note, and per-document inventoryraw_response.txt— the full pipe-delimited table(s) with**********markers, mirroring QualiGPT's raw output format
- Report the top themes to the user in chat with the table.
Feeding a codebook (bridge to beebe-policy-framing)
An inductive qualigpt run is the recommended first stage before deductive analysis with the beebe-policy-framing skill: its theme table is the raw material for that skill's codebook (themes → frame families; attributed speakers → actor codes; contested programs → activity codes). When the user's goal is framing/metaphor analysis, offer this two-stage path rather than asking them to invent a codebook cold.
Limitations to disclose
Per the QualiGPT paper: LLM-assisted coding is a first-pass aid, not a replacement for researcher judgment. Recommend the researcher (a) verify quotes against sources, (b) review theme boundaries, and (c) treat counts as approximate guides for salience. Note any documents that contributed little signal (e.g., forms, boilerplate). If documents duplicate one another, flag it — duplicates inflate source counts.
示例提示词
帮我对这批焦点团体访谈记录批量做主题分析并产出主题表。
所属插件
安装该插件会一并获得同领域的 58 个 Skill / MCP。
同插件的其他科研 Skill
- Mesa社会主体建模Builds Mesa agent-based models of opinion dynamics, segregation, social contagion, and network diffusion. Use when simulating emergent social behavior from agent rules.
- Mesa3主体建模引擎Builds agent-based models with the Mesa 3 AgentSet API, cell spaces, and batch_run sweeps for segregation, diffusion, and cooperation. Use for a Mesa 3.x ABM build or debug.
- 观察数据因果推断Estimates causal effects with DiD, IV, RDD, panel fixed effects, and propensity scores via statsmodels, linearmodels, DoWhy, and EconML. Use for observational or quasi-experimental causal estimation.
- 效应量元分析Pools effect sizes across studies with fixed/random-effects models, heterogeneity stats, forest/funnel plots, and publication-bias tests. Use for a systematic review’s quantitative synthesis.
- 缺失数据插补处理Handles missing data by naming the MCAR/MAR/MNAR mechanism, then applying multiple imputation (MICE) or FIML instead of single imputation. Use when a dataset has missing values to treat.
- 多层线性混合模型Fits mixed-effects/multilevel models (random slopes, ICC, GLMMs) for nested or longitudinal data via statsmodels, bambi, or R lme4/brms. Use for grouped data with within- vs between-cluster questions.
- 定性比较分析QCARuns crisp-, multi-value, and fuzzy-set Qualitative Comparative Analysis via R’s QCA package. Use for configurational or necessary/sufficient-condition research.
- 质性编码与主题分析Builds codebooks and computes intercoder reliability (Krippendorff’s alpha, kappa) for thematic or content coding, including human-vs-LLM double coding. Use when coding text or reporting reliability.
- 社会网络结构分析Computes network centrality, community detection, and ERGM inferential models matched to the research question via networkx/igraph. Use for social-network analysis beyond basic visualization.
- 社科研究设计把关Routes a study to its research design (experiment, quasi-experiment, observational, qualitative) and pins the identifying assumption first. Use when choosing a study design.
- 社科推论结论审核Audits inferential claims against the design before publication: unwarranted causal language, p-value/CI misreadings, and multiple-comparison issues. Use when checking a results section.
- 量表测量质量把关Checks that a scale’s reliability, validity, and measurement invariance are established before trusting or comparing it across groups. Use when adopting or reporting a survey instrument.
- 社科研究流程总控Coordinates a study through design, measurement, sampling, analysis, and inference gates with a shared Design Passport. Use for an end-to-end methodology review of a whole study.
- 质性研究可信度把关Gates qualitative trustworthiness before write-up: positionality, credibility, transferability, dependability, confirmability per Lincoln and Guba. Use before writing ethnographic findings.
- 抽样方法与样本量把关Checks that the sampling frame, method, and size match the inference paradigm before data collection. Use when planning recruitment or judging sample generalization.
- 复杂抽样调查分析Analyzes complex-sample survey data with design-based inference: weights, strata, PSUs, and calibration via Python svy or R survey/srvyr. Use for weighted surveys like GSS, ANES, or DHS.
- 文本数据定量分析Analyzes text as social-science data with topic modeling, embeddings, and validated dictionary or classification methods. Use for computational text analysis beyond a keyword count.
- 政策议题框架分析Runs anthropological framing and metaphor analysis on contested-policy documents, producing actor-attributed CSVs for NVivo import. Use for policy-framing or metaphor-analysis coding.
- 跨国比较政治分析Merges QoG, Polity5, and Freedom House data and runs cross-sectional OLS with fixed effects and regime classification. Use for comparative political-institution research.
- 计算社会学方法Covers social-media data collection, bot detection, network homophily, echo-chamber analysis, and conjoint survey experiments. Use for large-scale digital-trace sociology research.
- 冲突事件数据分析Downloads ACLED/UCDP conflict data and runs spatio-temporal clustering, conflict-onset logit panels, and fatality estimation. Use for quantitative armed-conflict research.
- 联合分析调查实验Designs conjoint survey experiments and estimates AMCEs via OLS, marginal means, and respondent-level heterogeneity. Use when designing or analyzing a choice-based conjoint experiment.
- 统计方法教学规范Defines the baseline statistical teaching and reproducibility standards shared across this analysis skill family. Use as the methodology reference other skills in the family build on.
- 人口统计方法分析Computes life tables, Leslie-matrix population projections, Lee-Carter mortality forecasts, and Kitagawa decomposition. Use for formal demographic analysis of mortality or population structure.
常见问题
QualiGPT主题分析能做什么?
Runs QualiGPT-style batch thematic analysis across interviews or documents, producing a theme table with quotes and source counts. Use for LLM-assisted thematic coding of a document batch。
如何安装QualiGPT主题分析?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「QualiGPT主题分析」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
QualiGPT主题分析需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
QualiGPT主题分析经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。