# Build forms with Shelly
URL: https://docs.awellhealth.com/docs/design-care-flows/build-forms-with-shelly

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).





Shelly sits inside Awell's form builder: describe an assessment in plain language and it drafts the
questions.

## Shelly drafts a new form or recreates an existing one [#shelly-drafts-a-new-form-or-recreates-an-existing-one]

Shelly produces a first draft to refine, which is faster than composing a form question by question in
an empty builder.

For an assessment that already exists, upload it and Shelly recreates it as an Awell form.

## Prompt Shelly while the form is open [#prompt-shelly-while-the-form-is-open]

<img alt="Shelly open beside the form builder, with a prompt describing the questions and answer options to create" src="__img0" />

Describe the workflow or assessment while designing a form, and Shelly creates or edits the questions.

## Detail in the prompt improves the draft [#detail-in-the-prompt-improves-the-draft]

* Give context. Detail about the use case produces a more usable draft.
* Name the question types. An answer that has to drive
  [conditional logic](/docs/design-care-flows/add-conditions-to-your-questions) can't be a date or free
  text, so say so up front.
* Iterate. The first output is a draft, not a finished form.

## Every drafted form needs a human review before publishing [#every-drafted-form-needs-a-human-review-before-publishing]

Read every question before it reaches a patient, and check what a generator can't know: whether the
wording matches the protocol, whether an instrument has to stay verbatim to remain valid, and whether
the answer options match what the logic downstream expects.

Don't generate a validated questionnaire.
[Import it from the library](/docs/design-care-flows/import-export-form-questions) instead, so the
wording and scoring stay intact.

## Next steps [#next-steps]

**Next:** [Encode questions and answer options](/docs/design-care-flows/encode-questions-and-answer-options),
which a generated form still needs.