avoid-leading-questions — Claude Code skill
avoid-leading-questions reviews a draft survey question, names the bias behind it, and gives a concrete rewrite for each of the three cases it covers.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a claude-codeWhat avoid-leading-questions does
Point the skill at a draft survey item and it works out which bias is at play: the respondent guessing what answer the researcher wants, hiding a behaviour that looks bad in public, or nodding along with whatever the scale says. Each case gets its own fix.
For a nudge in the wording, the fix is to cut the lead-in that announces the expected answer. Adding items you expect to be irrelevant helps too: anyone who rates them as highly as the important ones is chasing agreement with you, not answering. Sensitive topics get pointed toward list experiments, randomized response or records of actual behaviour instead of self-report.
A plain yes/no about insider trading or drug use is not treated as a finished measurement. It reads as a floor for the sample rather than a rate. Interpretation problems and recall problems belong to clarity-concreteness and survey-design-checklist; this one does not cover them.
What it helps with
- strip a line about what experts believe out of a draft item
- ask about insider trading without respondents underreporting
- swap a yes/no comprehension check for an open question
- diagnose a survey where every answer is “agree”
- pick a list experiment for a question on drug use
Example prompts for the agent
- Is this item leading? It opens with what experts believe before asking for the respondent's own view.
- How do I ask about insider trading so people don't lie?
- Everyone picks “agree” on every item of my survey — what should I change?
How to install avoid-leading-questions
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a claude-code2Manually: put the files in place
~/.claude/skills/avoid-leading-questions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/avoid-leading-questions/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a codex2Manually: put the files in place
.agents/skills/avoid-leading-questions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a cursor2Manually: put the files in place
.cursor/skills/avoid-leading-questions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills running-surveys-experiments/avoid-leading-questions/SKILL.md2Manually: put the files in place
.github/skills/avoid-leading-questions/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path running-surveys-experiments/avoid-leading-questionsManually: put the files in place
.devin/skills/avoid-leading-questions/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about avoid-leading-questions
How to install avoid-leading-questions in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill avoid-leading-questions -a claude-code. The skill lands at ~/.claude/skills/avoid-leading-questions/SKILL.md.
What does avoid-leading-questions do?
It sorts a survey item by the bias it is exposed to and returns a fix: drop the framing sentence, add items that should be irrelevant, or move a sensitive topic to indirect elicitation.
How is it different from clarity-concreteness and survey-design-checklist?
clarity-concreteness handles vague wording and survey-design-checklist checks whether respondents can recall what you ask about. This skill deals with willingness to answer honestly and with pressure from context.