> For the complete documentation index, see [llms.txt](https://guide.scribe.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.scribe.gov.sg/guides/learn-about-summaries/master-your-custom-summaries.md).

# Master your Custom Summaries

Whether you're writing clinical notes, meeting minutes, or research summaries, the key to getting great custom summaries that fit your needs lies in how you set up your summary generation.

<figure><img src="/files/5qa3ZCRmq99DhfnoCCWP" alt="" width="563"><figcaption></figcaption></figure>

[As covered in our basic guide](/guides/learn-about-summaries.md), there are 4 elements you can tweak to customise your summaries. Click through the toggles below to learn how to use these elements to generate effective summaries!

<details>

<summary>1: How to craft Descriptions</summary>

Think of the description as a way of **helping Scribe understand what happened in the session**. Share **who** <mark style="color:$info;background-color:$info;">was in the session</mark> and **what** <mark style="color:$danger;background-color:$danger;">this session was for</mark>. If more than 2 speakers were in the conversation, you can tell Scribe who they were in the description.

**Guide:** `How would you tell a colleague what your last conversation was about?`

<figure><img src="/files/FMnl97S2QawVI3TDZqvU" alt="" width="563"><figcaption></figcaption></figure>

**Some Examples:**

* <mark style="color:$info;background-color:$info;">I am a medical social worker meeting a patient, Mdm Lee,</mark> <mark style="color:$danger;background-color:$danger;">and we are discussing her discharge</mark>
* <mark style="color:$info;background-color:$info;">I am a social worker speaking to a client, John,</mark> <mark style="color:$danger;background-color:$danger;">and we’re reviewing his progress in his hygiene routines.</mark> <mark style="color:$info;background-color:$info;">His caregiver, Mr Tan was also present.</mark>

{% hint style="info" %}
**Tip! Be specific and include key context**

Multiple speakers? Specific goals? Add these in to help Scribe understand your session better.
{% endhint %}

</details>

<details>

<summary>2: How to craft Headers</summary>

Think of headers as the **specific topics that you want Scribe to write about** in your summary. When you define a header, Scribe uses them as **keywords** to **pull out relevant information within your transcript** to write about.

**Guide:** `How would you have structured your notes if you were writing it yourself?`Frame your headers around those topics

<figure><img src="/files/ZLMu2pZrUZpLUOt1M6SE" alt="" width="563"><figcaption></figcaption></figure>

**Some Examples:**

* Patient's family support at home
* Client's relationship with their caregiver
* Client's mobility concerns
* Feedback on client's toothbrushing routine

{% hint style="info" %}
**Tip! Be focused and specific**

Instead of "medication", use "medication side effects". Instead of "routines", try "client's adherence to new shower routine".
{% endhint %}

</details>

<details>

<summary>3: How to use Summary Style</summary>

**`Format`** Choose between having your summary generated in bullet points or prose

**`Level of Detail`** Choose between having your summary generated in standard or detailed levels

<figure><img src="/files/6bVB13UdevDMMe8mhSzY" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>4: How to use Custom Instructions</summary>

Think of custom instructions as a way of **telling Scribe exactly how you want your summaries written.**&#x20;

**Guide:** `How would you ask it to write in the style that you need?`

<figure><img src="/files/8z47ngUpUYbxrm52Ep3k" alt="" width="563"><figcaption></figcaption></figure>

**Some Examples:**

* "Include more details and verbatim in the caregiver feedback section to highlight emotional weight"
* "Keep the tone objective and avoid speculative language"
* "Use "Client" instead of "the client", refer to the social worker as ‘SW’

{% hint style="info" %}
Tip! You may also specify if you’d like Scribe to apply these instructions to the whole summary or just specific sections in your summary
{% endhint %}

</details>

{% hint style="info" %}

#### Crafting effective descriptions, headers & custom instructions takes trial and error!

Don't be afraid to generate multiple summaries with different configurations until you find something that works for your needs.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guide.scribe.gov.sg/guides/learn-about-summaries/master-your-custom-summaries.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.