> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Screening Instruments

> Read-only catalog of validated behavioral health screening instruments with auto-scoring metadata, severity bands, and critical alert thresholds.

The Screening Instruments screen displays the library of validated behavioral health screening instruments at the in-app route `/cl/screening-instruments`.

## Overview

The Screening Instruments page renders a static catalog sourced from `SCREENING_INSTRUMENT_CATALOG` (a client-side constant). There is no data fetching from the server on this page — instruments are defined in the application code. The page provides a text search input (filtering by instrument name, abbreviation, or category) and a tab bar with "All" plus one tab per category that has at least one instrument. Categories present in the catalog are: Depression, Anxiety, Alcohol, Substance Use, Suicide Risk, Trauma / PTSD, ACEs, and Withdrawal. Instrument codes in the catalog are: `phq9`, `gad7`, `audit_c`, `dast10`, `cssrs_screener`, `pcl5`, `ace`, `cage_aid`, `ciwa_ar`, `cows`. Each instrument card shows the abbreviation, category badge, full name, description, item count, max score, minimal clinically important change (MCC), severity bands with color-coded ranges, and critical alert threshold messages (if any) in a destructive-styled box, plus the citation string.

## Who it's for

Requires permission `cl.risk_screening.view`.

## Before you start

* Permission `cl.risk_screening.view` must be granted.
* This page displays a read-only instrument reference catalog; no server data is required for it to render.

## Steps

<Steps>
  <Step title="Browse the catalog">
    The page opens with all instruments displayed in a responsive grid (up to 3 columns on large screens).
  </Step>

  <Step title="Search for an instrument">
    Type in the search box to filter by instrument name, abbreviation, or category (e.g., type "PHQ" to find the PHQ-9, or "depression" to filter by category).
  </Step>

  <Step title="Filter by category">
    Click a category tab (Depression, Anxiety, Alcohol, Substance Use, Suicide Risk, Trauma / PTSD, ACEs, Withdrawal) to show only instruments in that category.
  </Step>

  <Step title="Review instrument details">
    Each card displays the abbreviation, full name, description, item count, max score, MCC (minimal clinically important change), severity bands with score ranges, and critical alert threshold messages.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Instrument categories">
    `depression`, `anxiety`, `alcohol`, `substance_use`, `suicide_risk`, `trauma`, `adverse_childhood`, `withdrawal` — from `InstrumentCategory` in `src/cores/cl/types/screening-instruments.ts`.
  </Accordion>

  <Accordion title="Instrument codes">
    `phq9`, `gad7`, `audit_c`, `dast10`, `cssrs_screener`, `pcl5`, `ace`, `cage_aid`, `ciwa_ar`, `cows` — from `ScreeningInstrumentCode` in `src/cores/cl/types/screening-instruments.ts`.
  </Accordion>

  <Accordion title="Critical alert thresholds">
    Instruments with `critical_thresholds` defined show a destructive-styled box on their card listing the alert messages. These thresholds drive clinical alerts when the instrument is administered.
  </Accordion>

  <Accordion title="Empty state">
    When the search text matches no instruments in the active tab, the message "No instruments match your search." is shown.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Overview of the Clinical core.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/cl.tsx
  * src/cores/cl/pages/ScreeningInstrumentsPage.tsx
  * src/cores/cl/types/screening-instruments.ts
</Accordion>