Skip to main content
affpapa.org
RU EN
skill CX Codex

instrument-designer — Claude Code skill: questionnaires and guides

Builds the data-collection tool itself: questionnaires, interview and focus-group guides, observation checklists. Useful once indicators exist but nothing measures them.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add gasserane/personal-skills --skill instrument-designer -a claude-code
Open on GitHub

What instrument-designer does

This skill designs the instrument, not the indicators and not the analysis. You give it the indicator set or research questions plus who the respondents are: collection mode (structured survey, qualitative interview, observation), age, context, language. It picks the instrument type, ties every item to a named target, and drops the orphans.

Seven steps sit inside. Disaggregation is one of them, and it is built as instrument items: age, gender identity kept separate from sex assigned at birth, disability through the Washington Group Short Set, geography. For an anonymous survey of a small internal group (roughly under 50 people) the standard demographic block de-anonymises respondents, so it is swapped for one coarse optional item and a minimum-cell-size rule. That deviation gets written into the design annex with a rationale.

Sensitive topics — adolescents, GBV, abortion, LGBTI+ — pull consent and assent scripts plus a care-referral pathway into the instrument before collection starts. Export runs through ane_package.reporting.word_export to Word; a structured questionnaire also gets assembled into an XLSForm via xlsform.write_xlsform, which uploads to KoboToolbox and bridges to the ane_package.ingest.sources.kobo adapter. Without those package modules the export fails.

What it helps with

  • write a questionnaire where every item maps to an indicator
  • draft a key-informant interview guide
  • lay out a focus-group questioning route with probes
  • build disaggregation into the instrument instead of coding it later
  • produce an XLSForm for deployment in KoboToolbox

Example prompts for the agent

  • Build a questionnaire for this indicator set, respondents are girls aged 15–19
  • Draft a semi-structured interview guide on access to services
  • Turn this questionnaire into an XLSForm for KoboToolbox

How to install instrument-designer

1Skills CLI (Vercel)

npx skills add gasserane/personal-skills --skill instrument-designer -a claude-code

2Manually: put the files in place

~/.claude/skills/instrument-designer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/instrument-designer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about instrument-designer

How do I install instrument-designer in Claude Code?

Run npx skills add gasserane/personal-skills --skill instrument-designer -a claude-code. The skill lands at ~/.claude/skills/instrument-designer/SKILL.md.

What does instrument-designer do?

It designs the data-collection tool: a questionnaire, an interview or focus-group guide, an observation checklist. Items are traced to indicators, and disaggregation and consent are part of the build.

How is it different from indicator-designer?

indicator-designer decides what to measure. instrument-designer makes the tool that produces the data. Analysing what you collect is a separate workflow.

Similar skills

All skills for Science and research →
survey-generation lingzhi227 Walks an agent through paper collection, outlining, writing and citation checking, then hands back a LaTeX survey with a .bib file. For when you need an actual literature review. CX Codex +1 1,700installs research-survey EvoScientist Turns a collected paper set into a structured survey: outline, draft, section-by-section expansion, comparison tables and citations. CX Codex +1 300installs measure-survey-analysis product-on-purpose Turns survey results into PM-ready findings: persona segments, themes in open-text answers, hypothesis status, and explicit warnings about what the data cannot support. CX Codex +1 634installs deep-research HKUSTDial Runs a topic investigation in the shape of a survey paper: pins the questions, searches from several angles, checks every reference and answers each question in the final report. Useful before you commit to a topic. CX Codex +1 510installs survey akillness This skill runs a bounded landscape scan before planning or implementation and stores reusable results in .survey/{slug}/. Use it to compare workflows and tools. CX Codex +1 385installs instrument-data-to-allotrope official anthropics Converts laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON or flattened CSV. Auto-detects instrument type and outputs ASM JSON, tabular CSV, and exportable parser code. CX Codex +1 2,400installs

From the same set13

decision-memo Turns a pending choice into a written memo: context, options, a recommendation, risks and reversibility. Useful when a decision needs a record. CX Codex +1 664installs ane-voice This skill reviews AI-written prose and reshapes it to Ane’s IPPF MEL/SRHR voice while keeping the argument rigorous. Use it for focused editorial passes. CX Codex +1 654installs li Catalogs, retrieves and reorganizes documents in a personal knowledge library and MEL Wiki. It does not answer domain questions. CX Codex +1 652installs toc-builder Builds a Theory of Change with preconditions, testable assumptions and an evidence plan. Useful for programme design and funder submissions. CX Codex +1 645installs wrap-up This skill closes a working session: it gathers git state, errors and open tasks, delivers a status report, then commits and pushes pending work. CX Codex +1 639installs grade-system This skill grades an MEL/SRHR system across components, quality dimensions, and adapted OECD-DAC criteria. Use it for a structured review of risks and evidence. CX Codex +1 633installs learning-product Turns a Researcher Evidence Brief into one of four outputs: a two-page MA brief, a workshop pack, a regional brief or a donor memo. Citations stay limited to the brief. CX Codex +1 626installs accreditation-desk-review Runs the desk-review stage of an IPPF Member Association accreditation: judge the self-assessment and evidence against each standard and check, record reviewer conclusions, and draft interview questions. CX Codex +1 557installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor