Agent skill

Questionnaire Design Guide

by wentorai in wentorai/research-plugins

Questionnaire and survey design with Likert scales and coding

MITAuto-check passedSales & Support

Install Questionnaire Design Guide

skills CLI
$ npx skills add wentorai/research-plugins --skill questionnaire-design-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins questionnaire-design-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/analysis/wrangling/questionnaire-design-guide .claude/skills/questionnaire-design-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
questionnaire-design-guide
GitHub stars
298
Used in
1 other repo
Token cost
~2.1k tokens
SKILL.md length
535 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Questionnaire and survey design with Likert scales and coding

  • Works in 4 steps: Clear: Avoid jargon, double-barreled… → Concise: Keep questions short (ideally… → Complete: Include all relevant response… → …
  • Tasks that involve Customer feedback analysis
  • SKILL.md covers Survey Design Principles, Likert Scale Design, Constructing a Multi-Item Scale and Data Coding and Preparation, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Questionnaire Design Guide is an agent skill from wentorai/research-plugins. Questionnaire and survey design with Likert scales and coding

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Customer feedback analysis. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Customer feedback analysis

Example prompts

  • “/questionnaire-design-guide”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Clear: Avoid jargon, double-barreled questions, and ambiguity
  2. Concise: Keep questions short (ideally under 20 words)
  3. Complete: Include all relevant response options
  4. Consistent: Use the same scale direction and format throughout

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and r).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Questionnaire Design Guide loads about 2.1k tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 535 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 535 words, ~2,082 tokens.

Download SKILL.mdSave it as .claude/skills/questionnaire-design-guide/SKILL.md (or your agent's skills folder).
name
questionnaire-design-guide
description
Questionnaire and survey design with Likert scales and coding

Questionnaire Design Guide

Design valid and reliable survey instruments with proper question types, Likert scale construction, response coding, and data preparation for analysis.

Survey Design Principles

Question Types
TypeExampleBest ForAnalysis
Likert scale"Rate your agreement: 1-5"Attitudes, perceptionsOrdinal/interval statistics
Multiple choice"Select your field"Demographics, categoriesFrequencies, chi-square
Ranking"Rank these 5 options"Preferences, prioritiesRank correlations
Open-ended"Describe your experience"Exploratory, rich dataQualitative coding
Matrix/gridMultiple items, same scaleEfficient battery of itemsFactor analysis, reliability
Slider/VAS0-100 visual analog scaleContinuous measuresParametric statistics
Semantic differential"Easy __ __ __ __ __ Difficult"Bipolar attitudesFactor analysis
The Four C's of Good Questions
  1. Clear: Avoid jargon, double-barreled questions, and ambiguity
  2. Concise: Keep questions short (ideally under 20 words)
  3. Complete: Include all relevant response options
  4. Consistent: Use the same scale direction and format throughout

Likert Scale Design

Scale Points
PointsScale ExampleRecommended Use
4-pointStrongly Disagree to Strongly AgreeForces choice (no neutral), less discriminating
5-pointSD, D, Neutral, A, SAMost common, good balance of simplicity and discrimination
7-pointSD, D, Somewhat D, Neutral, Somewhat A, A, SAMore discriminating, better for experienced respondents
11-point (0-10)Not at all to CompletelyNPS, continuous-like measures
Anchoring Labels
5-Point Agreement Scale:
1 = Strongly Disagree
2 = Disagree
3 = Neither Agree nor Disagree
4 = Agree
5 = Strongly Agree

5-Point Frequency Scale:
1 = Never
2 = Rarely
3 = Sometimes
4 = Often
5 = Always

5-Point Satisfaction Scale:
1 = Very Dissatisfied
2 = Dissatisfied
3 = Neutral
4 = Satisfied
5 = Very Satisfied
Reverse-Coded Items

Include 2-3 reverse-coded items per construct to detect acquiescence bias:

Regular:  "I find research methods interesting."        (1-5: SD to SA)
Reversed: "I find research methods tedious and dull."   (1-5: SD to SA)

# Recode reversed items before analysis:
# reversed_score = (max_scale + 1) - raw_score
# For a 5-point scale: reversed_score = 6 - raw_score

Constructing a Multi-Item Scale

Step-by-Step Process
  1. Define the construct: Write a clear conceptual definition
  2. Generate items: Write 1.5-2x the number of items you plan to keep (e.g., write 15 items for an 8-item scale)
  3. Expert review: Have 3-5 experts rate each item for relevance (Content Validity Index)
  4. Pilot test: Administer to 30-50 respondents
  5. Item analysis: Calculate item-total correlations, check reliability
  6. Exploratory Factor Analysis (EFA): Confirm dimensionality
  7. Finalize scale: Remove weak items, re-test reliability
Example: Research Self-Efficacy Scale
Construct: Belief in one's ability to conduct academic research

Items (5-point Likert, Strongly Disagree to Strongly Agree):
RSE1: I can formulate clear research questions.
RSE2: I can design an appropriate research methodology.
RSE3: I can analyze data using statistical software.
RSE4: I can write a publishable research paper.
RSE5: I can critically evaluate published research.
RSE6: I can present research findings at a conference.
RSE7R: I struggle to interpret statistical results. [REVERSED]
RSE8R: I find it difficult to synthesize literature. [REVERSED]

Data Coding and Preparation

Coding Scheme
python
import pandas as pd
import numpy as np

# Define coding scheme
likert_coding = {
    "Strongly Disagree": 1,
    "Disagree": 2,
    "Neither Agree nor Disagree": 3,
    "Agree": 4,
    "Strongly Agree": 5
}

# Apply coding
df["Q1_coded"] = df["Q1_raw"].map(likert_coding)

# Reverse code specific items
reverse_items = ["RSE7R", "RSE8R"]
max_scale = 5
for item in reverse_items:
    df[f"{item}_recoded"] = (max_scale + 1) - df[item]

# Calculate composite score (mean of items)
scale_items = ["RSE1", "RSE2", "RSE3", "RSE4", "RSE5", "RSE6",
               "RSE7R_recoded", "RSE8R_recoded"]
df["RSE_mean"] = df[scale_items].mean(axis=1)
Missing Data Handling
python
# Check missing data patterns
print(df[scale_items].isnull().sum())
print(f"Complete cases: {df[scale_items].dropna().shape[0]} / {df.shape[0]}")

# Common strategies:
# 1. Listwise deletion (if < 5% missing)
df_complete = df.dropna(subset=scale_items)

# 2. Mean imputation per item (simple but biased)
df[scale_items] = df[scale_items].fillna(df[scale_items].mean())

# 3. Person-mean imputation (if < 20% of items missing per person)
def person_mean_impute(row, items, max_missing=2):
    if row[items].isnull().sum() <= max_missing:
        return row[items].fillna(row[items].mean())
    return row[items]  # leave as NaN if too many missing

df[scale_items] = df.apply(lambda r: person_mean_impute(r, scale_items), axis=1)

Reliability Analysis

Cronbach's Alpha
python
import pingouin as pg

# Calculate Cronbach's alpha
alpha = pg.cronbach_alpha(df[scale_items])
print(f"Cronbach's alpha: {alpha[0]:.3f}")
# Interpretation: >= 0.70 acceptable, >= 0.80 good, >= 0.90 excellent
r
library(psych)

# Cronbach's alpha with item-level diagnostics
alpha_result <- alpha(data[, scale_items])
print(alpha_result)
# Check "raw_alpha if item dropped" to identify weak items
Item-Total Correlations
r
# Corrected item-total correlations (should be > 0.30)
item_stats <- alpha_result$item.stats
print(item_stats[, c("r.drop", "raw.alpha")])
# r.drop < 0.30: consider removing the item
# raw.alpha increases if dropped: item is weakening the scale
Show full SKILL.md (221 more words)Show less

Validity Assessment

Validity TypeMethodCriterion
Content validityExpert panel rating (CVI)I-CVI >= 0.78, S-CVI/Ave >= 0.90
Construct validityExploratory Factor Analysis (EFA)Eigenvalue > 1, loadings > 0.40
Convergent validityCorrelation with related constructr > 0.30
Discriminant validityCorrelation with unrelated constructr < 0.30
Criterion validityCorrelation with external criterionSignificant correlation
Test-retest reliabilityICC or Pearson r over 2-4 weeksICC > 0.70

Common Design Mistakes

MistakeExampleFix
Double-barreled question"This course is interesting and useful"Split into two separate items
Leading question"Don't you agree that X is important?""How important is X to you?"
Absolute terms"Do you always check citations?""How often do you check citations?"
Missing optionNo "Not Applicable" when neededAdd N/A option or filter logic
Inconsistent scale directionSome items 1=good, others 1=badStandardize direction; clearly mark reversed items
Too many items100-item surveyAim for 5-8 items per construct, 15-30 min total
No pilot testSkip straight to full deploymentAlways pilot with 30-50 respondents

Survey Platform Comparison

PlatformCostFeaturesBest For
QualtricsInstitutionalAdvanced logic, panels, APILarge academic studies
SurveyMonkeyFreemiumEasy to use, basic analysisQuick surveys
Google FormsFreeSimple, integrates with SheetsClassroom, pilot testing
LimeSurveyFree/self-hostedOpen source, full controlPrivacy-sensitive research
REDCapFree (academic)Clinical data, HIPAA compliantMedical/clinical research
ProlificPer-responseParticipant recruitmentOnline experiments

© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/analysis/wrangling/questionnaire-design-guide of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Questionnaire Design Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Questionnaire Design Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Questionnaire Design Guide this skillwentorai/research-plugins2981 repos~2.1kAutomated safety check: PassMIT
Review Analysisliangdabiao/amazon-sorftime-research-MCP-skill9591 repos~2.5kAutomated safety check: PassNone
Bggg Data Amazonbinggandata/bggg-skills605—~1.4kAutomated safety check: PassMIT
Zsxqunnoo/zsxq-skill304—~3.8kAutomated safety check: PassMIT
Roadtrip NavigatorWaybox-AI/roadtrip-skill126—~3.4kAutomated safety check: PassMIT
Always Compareai-analyst-lab/ai-analyst304—~1.4kAutomated safety check: PassMIT

Similar skills

  • Review Analysis

    liangdabiao/amazon-sorftime-research-MCP-skill

    对亚马逊商品评论进行深度分析,自动识别产品痛点、分析退货原因,生成改进建议和客服回复模板。Invoke when user uses /review-analysis command with a product ASIN.

    959 GitHub starsUsed in 1 repo~2.5k tokens
    Sales & SupportAuto-check passed
  • Bggg Data Amazon

    binggandata/bggg-skills

    Collect Amazon.com written product reviews at scale through Woot's public review AJAX route, retain every attempt and error log, reconcile partial runs, and normalize exact review text into…

    605 GitHub stars~1.4k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Zsxq

    unnoo/zsxq-skill

    知识星球 CLI(zsxq-cli)与底层接口完整操作指南,涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI…

    304 GitHub stars~3.8k tokensUpdated 19 days ago
    Sales & SupportAuto-check passed
  • Roadtrip Navigator

    Waybox-AI/roadtrip-skill

    Generate North American road-trip itineraries as a map-first, offline-friendly single-file HTML page.

    126 GitHub stars~3.4k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Always Compare

    ai-analyst-lab/ai-analyst

    Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another segment) or state that none is available.

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Sales & SupportAuto-check passed
  • Account Deletion

    gustavscirulis/snapgrid

    Generates an Apple-compliant account deletion flow with multi-step confirmation UI, optional data export, configurable grace period, Keychain cleanup, and server-side deletion request.

    116 GitHub starsUsed in 1 repo~2.5k tokens
    Sales & SupportAuto-check: notes

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Categories

Questions about Questionnaire Design Guide

What does Questionnaire Design Guide do?

Questionnaire and survey design with Likert scales and coding. Questionnaire Design Guide is an agent skill from wentorai/research-plugins.

When should I use Questionnaire Design Guide?

Questionnaire Design Guide fits situations like: tasks that involve Customer feedback analysis.

How do I install Questionnaire Design Guide in Claude Code?

Run `npx skills add wentorai/research-plugins --skill questionnaire-design-guide -a claude-code`. Or copy the skill folder (skills/analysis/wrangling/questionnaire-design-guide in wentorai/research-plugins) into .claude/skills/questionnaire-design-guide in your project. Claude Code loads it when a task matches its description.

How do I install Questionnaire Design Guide in Codex?

Run `npx skills add wentorai/research-plugins --skill questionnaire-design-guide -a codex`. Or copy the skill folder (skills/analysis/wrangling/questionnaire-design-guide in wentorai/research-plugins) into .agents/skills/questionnaire-design-guide in your project. Codex loads it when a task matches its description.

Can I use Questionnaire Design Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill questionnaire-design-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/questionnaire-design-guide, .gemini/skills/questionnaire-design-guide, .github/skills/questionnaire-design-guide and .opencode/skills/questionnaire-design-guide in your project.

What does Questionnaire Design Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Questionnaire Design Guide is instructions for the agent only. Our summary lists: Python 3.

Does Questionnaire Design Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Questionnaire Design Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Questionnaire Design Guide use?

Questionnaire Design Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Questionnaire Design Guide use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Questionnaire Design Guide?

Skills that share tags, products or a category with Questionnaire Design Guide: Review Analysis (liangdabiao/amazon-sorftime-research-MCP-skill, 959 stars), Bggg Data Amazon (binggandata/bggg-skills, 605 stars), Zsxq (unnoo/zsxq-skill, 304 stars) and Roadtrip Navigator (Waybox-AI/roadtrip-skill, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Questionnaire Design Guide?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.