Install
openclaw skills install @usertold/usertold-recruit-participantsPlan truthful participant recruitment
openclaw skills install @usertold/usertold-recruit-participantsTurn a research question into a small, truthful recruitment plan for people the team can already reach. Recruitment is distribution into a UserTold Study, not a marketing funnel.
Read references/channel-selection.md, choose one primary channel, and name one meaningfully contrasting channel. Explain why each reaches the target behavior and add one explicit sampling-bias sentence.
Email and CRM are distribution only: special URL → expanded Invitation → explicit Start. The participant must select Start before permissions or recording. A link is never consent. Do not claim UserTold sends email, operates a CRM, or personalizes the link to an identity.
Track source with channel-level utm_source, utm_medium, and utm_campaign values where the host flow preserves them. Use campaign labels, not personal data. Report response and completion by source without turning the result into a representative-sample claim.
Read references/rewards.md. State all four terms exactly:
About $80/hour is marketplace orientation for human-moderated consumer interviews, not a universal rate or a calculator. AI-moderated and short in-product interviews normally use a smaller fixed reward. Participant copy must show the actual promise, such as “20 minutes · $25 gift card.” UserTold records the promise; it does not fulfill payment.
Choose one presentation_mode:
passive: a compact launcher the participant opens; use for voluntary feedback or a standing bug-report route.contextual: show an expanded panel on a relevant product route; use when current product context matters.direct_link: distribute the generated recruitment_url; use for email, CRM, community posts, or a targeted new-feature test. It does not participate in automatic page placement.For automatic placement, define Visibility v1 with the fewest include/exclude rules needed. State when recruitment opens and closes plus any maximum-participant or contact-cadence rule as an operational timing plan. Visibility does not encode dates or display frequency; do not invent fields for them or claim UserTold enforces an outreach cadence. Respect remembered Minimize and Hide choices. Never interrupt an intake, interview, or completion flow, and never convert observed frustration into an automatic interruption.
Ask only questions needed to determine the behavioral boundary. Use balanced answer options and neutral wording that does not signal which answer qualifies. Put qualification logic in qualification_rules, not in participant copy. Do not ask for contact details unless the workflow requires them and the participant agrees.
Provide:
title, welcome_message, and concise consent_text;questions using the existing Intake fields (question_text, question_type, required, optional options, numeric bounds, and qualification_rules);Recontact permission is consent, not qualification. Do not put it in qualification_rules or claim an ordinary Intake question writes UserTold's response-level consent_followup value. If the discovered participant flow cannot capture separate recontact consent, flag that limitation and leave recontact off.
The public UserTold MCP surface can create or update Studies with Invitation and Visibility. It does not expose a new recruitment or Intake tool. Produce Intake inputs for the dashboard or published CLI unless the live discovered surface explicitly supports more.
Return this compact packet:
invitation, visibility, intake_create, and optional intake_update objects directly usable with shipped UserTold fields. Put title, welcome_message, consent_text, max_participants, and questions in intake_create; put disqualified_message or other post-create copy in intake_update. Do not emit an invented combined intake schema.Use only Invitation fields and enums shown in references/invitation-examples.md. contextual and direct_link require a panel. Omit reward entirely when there is no reward. Keep one reward promise, and never add payment, email, CRM, participant-sourcing, identity, or sampling fields to the JSON.
Before writing through UserTold, discover the live MCP operations. Prefer studies.get to inspect an existing Study and studies.create or studies.update for supported fields. Show the packet and require explicit approval before activating a Study or Intake or changing a live Invitation/Visibility configuration.
Confirm that participant copy and JSON agree on duration and reward, direct links require explicit Start, qualification answers are not telegraphed, recontact is not used as qualification, source tracking contains no identity, and the bias note names who the chosen channel misses. Read the relevant scenario in references/invitation-examples.md when the offer is unusual or a direct link is involved.