# quality-checks-diagnosis

quality-checks-diagnosis helps choose the right survey check and interpret failures. Use it when you need to distinguish inattention from unclear instructions or a weak experimental treatment.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/running-surveys-experiments/quality-checks-diagnosis/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/quality-checks-diagnosis

## What it does

The skill separates attention checks, comprehension checks, and manipulation checks. It connects each failure type to a different part of the study to review: the respondent’s data, the instructions, or the treatment design. A failed comprehension check can point to confusing instructions rather than an inattentive respondent.

It recommends 1–2 attention checks, 1–2 comprehension checks before items about the study construct, and one manipulation check per treatment arm. It also advises counterbalancing check positions so their place in the survey does not skew failure rates. This skill focuses on choosing and interpreting checks, not on revising question wording or planning the operational flow of a pilot.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill quality-checks-diagnosis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/quality-checks-diagnosis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/quality-checks-diagnosis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill quality-checks-diagnosis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/quality-checks-diagnosis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill quality-checks-diagnosis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/quality-checks-diagnosis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills running-surveys-experiments/quality-checks-diagnosis/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/quality-checks-diagnosis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill quality-checks-diagnosis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path running-surveys-experiments/quality-checks-diagnosis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/quality-checks-diagnosis/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/running-surveys-experiments/quality-checks-diagnosis/SKILL.md

## When to use it
- choose a check type for a survey
- diagnose why respondents fail checks
- test whether respondents understand instructions
- assess whether an experimental treatment had its intended effect
- decide how many checks to include

## Example prompts
- Help me choose checks for my survey: I’m unsure whether I need attention checks or comprehension checks.
- Respondents are failing a check. Identify what the failure might mean and what I should revise.
- How can I tell whether respondents noticed the difference between the experimental conditions?

## Similar
- [alibabacloud-aes-sysom-os-diagnosis](https://affpapa.org/en/nevibecode/skills/alibabacloud-aes-sysom-os-diagnosis.md) — skill · 139 installs
- [huawei-cloud-modelarts-training-diagnosis](https://affpapa.org/en/nevibecode/skills/huawei-cloud-modelarts-training-diagnosis.md) — skill · 129 installs
- [breakdown-diagnosis](https://affpapa.org/en/nevibecode/skills/breakdown-diagnosis.md) — skill · ★ 47914 repo stars
- [authoring-data-quality-checks](https://affpapa.org/en/nevibecode/skills/authoring-data-quality-checks.md) — skill · 148 installs
- [quality-checks](https://affpapa.org/en/nevibecode/skills/quality-checks.md) — skill · ★ 234 repo stars
- [tooluniverse-rare-disease-diagnosis](https://affpapa.org/en/nevibecode/skills/tooluniverse-rare-disease-diagnosis.md) — skill · 415 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
