> For the complete documentation index, see [llms.txt](https://guide.plusai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.plusai.com/ai-for-presentations/generate-a-presentation/how-to-write-a-good-prompt.md).

# How to write a good prompt

## Structuring your prompt

Here are some quick tips. You can read more on our [blog](https://www.plusdocs.com/blog/how-to-write-an-effective-ai-prompt).

* Include context about the type of presentation and audience.
* In addition to the overall topic, you can also ask for specific content to be included.

Remember you can always use text to presentation and slide-by-slide mode if you need more control than a short prompt.

<figure><img src="https://3528250745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F54nb5b7bqXPHgn40UzoV%2Fuploads%2FxLP6codXCMTeRTeWk0k4%2Fimage.png?alt=media&amp;token=e401db76-6970-4fac-afad-e00b8a1377e0" alt=""><figcaption><p>Save this cheatsheet for writing a good AI prompt.</p></figcaption></figure>

## Do's and Don'ts

Here are some types of instructions that don't work well with Plus AI and suggestions for what to do instead.

* ❌ **Don’t** put specific design instructions in the prompt. Plus AI will ignore your instructions about colors and fonts. ✅ **Do:** Create a [custom theme](https://guide.plusdocs.com/plus-ai/custom-themes) to use when generating presentations.
* ❌ **Don’t** add instructions about the number of slides in your prompt. ✅  **Do:** Use the dropdown in the add-on to select the exact number of slides you want. (If these instructions conflict, Plus AI tends to get quite confused 🥴)
* ❌ **Don’t** ask Plus AI to create a presentation on current events. Plus AI doesn’t know about them. ✅ **Do:** Use [text to presentation](https://guide.plusdocs.com/plus-ai/generate-a-presentation/text-to-presentation) mode to paste in a news article or other document and transform it into a presentation.
* ❌ **Don't** add URLs in the prompt for Plus AI. It will not be able to navigate to them to read or digest your website or document. ✅ **Do:** Use [text to presentation](https://guide.plusdocs.com/plus-ai/generate-a-presentation/text-to-presentation) mode to paste in the content that you want Plus to summarize.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guide.plusai.com/ai-for-presentations/generate-a-presentation/how-to-write-a-good-prompt.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
