# Awell Score
URL: https://docs.awellhealth.com/docs/improve-and-analyse/awell-score

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



**Awell Score** is a library of clinical calculations and validated measurement instruments, such as
PHQ-9, GAD-7 and EQ-5D, each carrying the scoring rules that turn answers into a number. A care flow
can call one to score a patient's answers automatically, and the library can be browsed before any of
that is built.

Awell Score is **CE-marked**, meaning it carries the European conformity mark certifying a product
against the European Union requirements that apply to it. It works without the rest of Awell.

## A validated instrument makes the number comparable [#a-validated-instrument-makes-the-number-comparable]

Deciding what a care flow should improve is the subject of
[Decide what to improve](/docs/improve-and-analyse/decide-what-to-improve). The step after it is
choosing the instrument that produces the number. A questionnaire written for one care flow produces
a score only that care flow can interpret, which leaves nothing to compare it against.

A validated instrument avoids this. The measurement can be compared against published literature,
against a benchmark, and against the same instrument used elsewhere in the organization.

## What the Score Browser holds [#what-the-score-browser-holds]

The [Awell Score Browser](https://score.awellhealth.com/) lists every calculation in the library,
filterable by name, with a page for each one. The library spans mental health, quality of life,
substance use, orthopedics, endocrinology, and general clinical calculators, alongside plain utilities
like BMI and age.

Examples from across that range:

| Instrument        | Measures                               | Browse                                                                              |
| ----------------- | -------------------------------------- | ----------------------------------------------------------------------------------- |
| PHQ-9             | Depression severity                    | [phq\_9](https://score.awellhealth.com/calculations/phq_9)                          |
| GAD-7             | Generalized anxiety                    | [gad\_7](https://score.awellhealth.com/calculations/gad_7)                          |
| AUDIT             | Alcohol use                            | [audit](https://score.awellhealth.com/calculations/audit)                           |
| EQ-5D-5L          | General health-related quality of life | [eq5d\_5l](https://score.awellhealth.com/calculations/eq5d_5l)                      |
| PROMIS-10         | Global physical and mental health      | [promis\_10](https://score.awellhealth.com/calculations/promis_10)                  |
| Oxford Knee Score | Knee replacement outcomes              | [oxford\_knee\_score](https://score.awellhealth.com/calculations/oxford_knee_score) |

## Each calculation page carries what a form needs [#each-calculation-page-carries-what-a-form-needs]

Opening a calculation shows the instrument's questions, its answer options, and the score each option
carries. For the form that has to feed it:

* **The question keys.** Each question has a key, such as `AUDIT_Q01`. The calculation matches on
  these keys, so a form has to use them.
* **Copy answer options.** Each question offers its answer options for copying, with the scores
  already attached, so the options don't have to be retyped and re-scored by hand.
* **Simulate calculation.** Answers can be entered and scored on the spot, which confirms the
  instrument behaves as expected before a care flow depends on it.

Each page also links the instrument's own documentation, covering how its questions and answers should
be interpreted and what a given score means.

## Fitting a calculation into a care flow [#fitting-a-calculation-into-a-care-flow]

Inside Studio, a **Calculation** action runs the instrument against data the care flow has already
collected, and the care flow can then branch on the result, put it in a message, or send it onward.
[Add a calculation](/docs/design-care-flows/add-a-calculation) covers that build.

Importing a library questionnaire brings the keys the calculation expects, covered in
[Import and export form questions](/docs/design-care-flows/import-export-form-questions). Where a
form is written by hand,
[Encode questions and answer options](/docs/design-care-flows/encode-questions-and-answer-options)
covers matching the keys and values the instrument needs.

## Score runs without a care flow [#score-runs-without-a-care-flow]

Score is a separate product with its own REST API, so a system that never runs a care flow can still
call it to score a questionnaire it collected elsewhere. Engineers building that integration should
start at the [Awell Score API](/api-reference/score/awell-score-api).

## Next steps [#next-steps]

**Next:** [Know whether it worked](/docs/improve-and-analyse/know-whether-it-worked) — an instrument
produces the number, and this turns that number into a claim about whether the care flow changed
anything.

* Browse the library at [score.awellhealth.com](https://score.awellhealth.com/) to find an instrument
  for a specific condition or outcome.
* [Add a calculation](/docs/design-care-flows/add-a-calculation) to run one inside a care flow.
* Email [support@awellhealth.com](mailto:support@awellhealth.com) if the instrument a care flow needs
  isn't in the library.