agentsclimarketplace

Alterlab survey design

Skill AlterLab-IEU/AlterLab-Academic-Skills/skills/research-tools/alterlab-survey-design

239 evaluated academic Claude/agent skills across 17 research domains (bioinformatics, data science, clinical, social-science methods, Turkish academia & more). Executable eval per skill, deterministic citation verifier, research→write→review→publish pipeline, and a skill-finder front door. Claude Code, Cursor, Codex, Gemini CLI & Copilot.

Install
npx -y skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-survey-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Comprehensive survey and instrument design assistant supporting questionnaire construction, Likert scale design, question types (open/closed/matrix), response bias mitigation, sampling strategies (probability/non-probability), pilot testing, instrument validation (Cronbach's alpha, factor analysis), online survey tools (Qualtrics, REDCap, Google Forms), interview protocol development, focus group facilitation, mixed-mode surveys, and cultural adaptation of instruments. Use when designing a survey or questionnaire, building Likert scales, planning a sampling strategy, pilot testing, validating an instrument (Cronbach's alpha, factor analysis), developing an interview protocol, improving response rates, or working in Qualtrics or REDCap. For analyzing interview/focus-group data use alterlab-qualitative-methods; for qual+quant integration alterlab-mixed-methods; for test selection/power analysis alterlab-statistical-analysis; for IRB/consent alterlab-research-ethics. Part of the AlterLab Academic Skills suite.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

18.3 KB, ~3.7k tokens by cl100k_base, as published. Nobody here has run it

Survey Design — Survey & Instrument Design Agent

A comprehensive survey and instrument design tool for faculty and researchers. Covers the full lifecycle of survey-based research: from construct definition and item writing through pilot testing, validation, deployment, and analysis of survey data.

Overview

Survey research is one of the most widely used methods across social sciences, health sciences, education, and business. Despite its apparent simplicity, designing a valid and reliable survey instrument requires systematic attention to construct definition, item wording, response format, sampling, bias mitigation, and psychometric validation.

This skill treats survey design as a scientific process, not an art. Every design decision should be justified and documented.

When to Use This Skill

This skill should be used when:

  • Designing a new survey or questionnaire from scratch
  • Adapting an existing instrument for a new population or context
  • Writing Likert-scale items or other structured response formats
  • Developing interview protocols or focus group guides
  • Planning sampling strategies for survey research
  • Conducting pilot tests and cognitive interviews
  • Validating instruments (reliability and validity analysis)
  • Selecting online survey platforms (Qualtrics, REDCap, Google Forms)
  • Improving response rates and reducing bias
  • Conducting cultural adaptation and translation of instruments
  • Teaching research methods courses that include survey design

Does NOT Trigger

ScenarioUse Instead
Qualitative data analysis (coding, themes, focus group/interview analysis)alterlab-qualitative-methods
Integrating qual + quant strands (convergent/sequential designs, joint displays)alterlab-mixed-methods
Hypothesis-test selection, assumption checks, power analysis beyond validationalterlab-statistical-analysis
Specialized social-science methods (Delphi, Q-methodology, QCA)alterlab-social-science-methods
Writing the research paperalterlab-paper-writer
Ethics/IRB applications, informed consent for survey researchalterlab-research-ethics

Core Capabilities

1. Survey Design Process

The 10-Step Survey Design Framework:

Step 1:  Define research objectives and constructs
         What do you want to measure? What are your research questions?
              │
Step 2:  Review existing instruments
         Has someone already validated an instrument for your construct?
              │
Step 3:  Define the target population and sampling frame
         Who will you survey? How will you reach them?
              │
Step 4:  Choose survey mode
         Online, paper, phone, in-person, mixed-mode?
              │
Step 5:  Write items and response options
         Craft questions that are clear, unambiguous, and aligned to constructs
              │
Step 6:  Design survey structure and flow
         Organize sections, add skip logic, manage survey length
              │
Step 7:  Expert review
         Subject matter experts and methodologists evaluate the instrument
              │
Step 8:  Cognitive interviews and pilot testing
         Test with a small sample from the target population
              │
Step 9:  Psychometric validation
         Reliability analysis, factor analysis, validity assessment
              │
Step 10: Deploy, monitor, and analyze
         Launch survey, track response rates, clean and analyze data

2. Construct Definition and Operationalization

Before writing a single item, define what you are measuring. Map each construct to its dimensions, indicators, distinct-but-related constructs, and a nomological network so every item traces back to something specific.

Full Construct Mapping Template: see references/item_writing_and_scales.md.

3. Item Writing

Question Types and When to Use Them

TypeFormatBest For
Closed-ended (single choice)Radio buttonsMutually exclusive categories
Closed-ended (multiple choice)CheckboxesNon-mutually exclusive categories
Likert scaleRating scaleAttitudes, perceptions, frequency
Semantic differentialBipolar scaleEvaluative judgments
RankingDrag-and-drop or numberedForced prioritization
Matrix/GridLikert items in tableMultiple items with same response scale
Open-endedText boxExploratory, rich responses
NumericNumber inputPrecise quantities
Visual analog scale (VAS)SliderContinuous measurement

Likert Scale — Number of Points

PointsTrade-offUse When
4-pointForces a choice (no midpoint)Avoid social desirability midpoint clustering
5-pointMost common, well-understood; central-tendency biasStandard attitudinal measurement
6-pointForced choice with more granularityForce direction with more options
7-pointGreater discrimination; better for factor analysisEstablished psychometric instruments

Item-writing essentials — DO: simple/clear language; one concept per item (no double-barreled); specific time frames; match scale to stem; pilot with the target population; over-generate items. DO NOT: leading/loaded language; double negatives; assume knowledge; use absolutes; write overly long items; ask about hypotheticals when you mean actual behavior.

Full question-type examples, Likert labeling schemes, the complete DO / DO NOT rules, and worked before/after item revisions: see references/item_writing_and_scales.md.

4. Survey Structure and Flow

Organize the instrument as: welcome + consent → screening → main content grouped by construct (easy questions first, sensitive items mid-survey) → demographics at the end → thank-you/debrief. Use skip logic to hide irrelevant questions and route ineligible respondents.

Full Survey Structure Template and Skip Logic Design examples: see references/item_writing_and_scales.md.

5. Sampling Strategies

Probability Sampling (every member has a known, non-zero chance of selection; generalizable):

MethodHow It WorksTrade-off
Simple randomSelect randomly from complete listUnbiased, but needs a complete sampling frame
SystematicSelect every kth elementEasy, but periodicity risk if list has a pattern
StratifiedRandom sample within population strataEnsures subgroup representation; needs population knowledge
ClusterRandomly select clusters, then sample withinPractical without individual list; higher sampling error
Multi-stageCombine methods (cluster then stratified)Flexible for large populations; complex to analyze

Non-Probability Sampling (no representativeness guarantee):

MethodHow It WorksTrade-off
ConvenienceRecruit whoever is availableFast/cheap, but strong bias
PurposiveSelect on specific criteriaTargets relevant subgroups; researcher bias
SnowballParticipants recruit othersReaches hidden populations; biased toward the connected
QuotaConvenience sample within subgroup quotasEnsures diversity; not truly random within quotas

Size the sample with the proportion formula n = (Z² × p × (1-p)) / E² for descriptive surveys (adjusting for finite population and expected response rate), or a power analysis for comparative surveys. Worked sample-size formulas and the Python two-group power-analysis helper: see references/sampling_and_power.md.

6. Response Bias Mitigation

Bias TypeDefinitionMitigation Strategies
Social desirabilityRespondents answer in ways they believe are socially acceptableAnonymous data collection; indirect questioning; validated social desirability scales (e.g., Marlowe-Crowne)
AcquiescenceTendency to agree with statements regardless of contentMix positively and negatively worded items; use forced-choice formats
Central tendencyTendency to select middle response optionsUse even-point scales (no midpoint); provide behavioral anchors
Extreme respondingTendency to select extreme endpointsUse more response options (7-point); provide clear anchor descriptions
Order effectsEarlier questions influence responses to later questionsRandomize item order within sections; counterbalance across respondents
Nonresponse biasSystematic differences between responders and non-respondersFollow-up reminders; analyze early vs. late responders; compare demographics to population
Recall biasInaccurate recall of past eventsUse shorter recall periods; provide memory aids; use event-specific prompts
Common method biasInflated correlations due to same measurement methodUse different measurement methods; temporal separation; marker variables

7. Pilot Testing

Run a three-phase pilot before full deployment: (1) expert review for content/face validity (CVI thresholds: Item-CVI ≥ 0.78, Scale-CVI/Ave ≥ 0.90); (2) cognitive interviews (n = 5-10) using think-aloud and probing questions; (3) a quantitative pilot (n = 30-50) assessing completion, missing data, distributions, internal consistency, and item-total correlations.

Full phase-by-phase protocol with probe scripts and the quantitative-pilot checklist: see references/pilot_and_validation.md.

8. Instrument Validation

Assess reliability (Cronbach's alpha per subscale, corrected item-total correlations — flag items < 0.30) and validity across the evidence types below. Use exploratory factor analysis (Bartlett's test, KMO, eigenvalues, rotated loadings) to check internal structure.

TypeQuestionMethod
Content validityDo items cover the construct adequately?Expert review, CVI calculation
Face validityDo items appear to measure the construct?Target population review
Construct validityDoes it measure the theoretical construct?Factor analysis (EFA/CFA)
Convergent validityDoes it correlate with similar measures?Correlation with established instruments (r > 0.50)
Discriminant validityIs it distinct from different constructs?Low correlation with unrelated measures (r < 0.30)
Criterion (concurrent)Does it correlate with a current criterion?Correlation with gold standard, measured simultaneously
Criterion (predictive)Does it predict a future outcome?Correlation with criterion measured later
Known-groupsCan it distinguish groups known to differ?Compare scores between groups that should differ

Runnable Python for Cronbach's alpha, item-total correlations, EFA, and the three-phase pilot protocol: see references/pilot_and_validation.md. For CFA fit indices, measurement invariance, and the broader psychometric framework, see references/survey-methodology.md.

9. Online Survey Platform Comparison

FeatureQualtricsREDCapGoogle FormsLimeSurvey
CostInstitutional license (expensive)Free for institutionsFreeFree (open source)
Skip logicAdvancedAdvancedBasicAdvanced
RandomizationYes (items, blocks)LimitedNoYes
PipingYesYesNoYes
Offline data collectionYes (app)Yes (app)NoYes
HIPAA compliantYes (BAA available)Yes (designed for it)NoSelf-hosted: yes
API accessYesYesLimitedYes
Data exportCSV, SPSS, ExcelCSV, Excel, SPSS, SAS, R, StataCSV, ExcelCSV, Excel, SPSS, R
Multi-languageYesYesManualYes
Panel integrationYes (Prolific, MTurk)NoNoLimited
Best forComplex academic surveysClinical and health researchSimple surveys, course evaluationsBudget-conscious complex surveys

10. Interview Protocol Development

Build semi-structured interview guides with a scripted opening/consent, a warm-up question, main-question blocks organized by construct (each with probes), a closing catch-all, and a post-interview field-notes routine.

Full Semi-Structured Interview Guide Template: see references/qualitative_protocols.md.

11. Focus Group Facilitation

Plan groups of 6-10 (4-6 for complex topics), 3-5 groups per segment until saturation, homogeneous within and heterogeneous across. Assign moderator and note-taker roles, prepare a neutral environment, and use funnel-approach facilitation to manage dominant and quiet voices.

Full Focus Group Design Checklist: see references/qualitative_protocols.md.

12. Cultural Adaptation of Instruments

Adapt instruments across languages/cultures using Brislin's (1970) back-translation cycle (forward translation → independent back-translation → reconciliation → cultural review → cognitive interviews → validation) and the 10-step ISPOR cross-cultural adaptation guidelines.

Full back-translation flow diagram and ISPOR step list: see references/qualitative_protocols.md.


Best Practices

  1. Start with constructs, not questions. Define exactly what you are measuring before writing a single item. Each item should trace back to a specific construct or dimension.

  2. Use existing validated instruments when possible. Do not reinvent the wheel. Search the literature for instruments with established psychometric properties.

  3. Pilot everything. Every survey should go through cognitive interviews and a quantitative pilot before full deployment. There is no substitute for testing with your target population.

  4. Keep it short. Every additional item increases dropout risk. Include only items you will actually analyze. A good survey is as short as possible and as long as necessary.

  5. Design for your weakest respondent. Write at an appropriate reading level. Test on mobile devices. Consider accessibility (screen readers, color contrast). Provide translations if needed.

  6. Randomize item order within sections. This reduces order effects and helps detect careless responding.

  7. Include attention checks. Embed 1-2 instructed response items (e.g., "Please select 'Agree' for this item") to identify careless respondents.

  8. Plan your analysis before collecting data. Every question should have a purpose in your analysis plan. If you cannot say how you will analyze an item, remove it.

  9. Document everything. Keep a survey design log recording every decision: why items were added, removed, or revised; pilot test results; expert feedback.

  10. Protect respondent data. Use anonymous links when possible; store data securely; minimize collection of identifiers; comply with IRB requirements.


Common Pitfalls

PitfallWhy It HappensHow to Avoid
Double-barreled questionsTrying to be efficient; asking two things at onceSplit into separate items; one concept per item
Leading questionsResearcher's hypothesis influences wordingHave a colleague blind to your hypothesis review items
Response options that do not match the stemCopy-pasting from another surveyEnsure stem and response scale are grammatically and logically matched
Too many open-ended questionsWanting rich dataLimit to 2-3 open-ended items; save depth for interviews
No pilot testingTime pressure; overconfidence in item clarityAlways pilot — even a quick cognitive interview with 3-5 people helps
Ignoring mobile respondentsDesigning on desktopTest on multiple devices; avoid matrix questions on mobile (they break)
Low response rateNo follow-up plan; survey too long; no incentivePre-notify; send reminders (3-4 contacts); shorten survey; offer incentive
Neglecting psychometric validationAssuming items are valid because they "look right"Run reliability and factor analysis; report results in your paper
Convenience sampling reported as representativeNot understanding sampling limitationsBe honest about sampling method in limitations section
Cultural insensitivityAssuming instruments transfer across culturesUse formal adaptation procedures (back-translation, cognitive interviews)

References

  • DeVellis, R. F., & Thorpe, C. T. (2022). Scale development: Theory and applications (5th ed.). Sage.
  • Dillman, D. A., Smyth, J. D., & Christian, L. M. (2014). Internet, phone, mail, and mixed-mode surveys: The tailored design method (4th ed.). Wiley.
  • Fowler, F. J. (2014). Survey research methods (5th ed.). Sage.
  • Groves, R. M., Fowler, F. J., Couper, M. P., Lepkowski, J. M., Singer, E., & Tourangeau, R. (2009). Survey methodology (2nd ed.). Wiley.
  • Krosnick, J. A., & Presser, S. (2010). Question and questionnaire design. In P. V. Marsden & J. D. Wright (Eds.), Handbook of survey research (2nd ed., pp. 263-313). Emerald.
  • Podsakoff, P. M., MacKenzie, S. B., Lee, J. Y., & Podsakoff, N. P. (2003). Common method biases in behavioral research. Journal of Applied Psychology, 88(5), 879-903.
  • Willis, G. B. (2005). Cognitive interviewing: A tool for improving questionnaire design. Sage.

See also: references/survey-methodology.md for expanded methodology details.

What ships with it: 6 files

39.8 KB alongside SKILL.md

evals/

Keep looking

Skills are one crate of 327,132. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.