diff --git a/docs/src/content/docs/setup/creating-workflows.mdx b/docs/src/content/docs/setup/creating-workflows.mdx
index b312d4d6aa..c07df45e93 100644
--- a/docs/src/content/docs/setup/creating-workflows.mdx
+++ b/docs/src/content/docs/setup/creating-workflows.mdx
@@ -12,6 +12,13 @@ You can author new agentic workflows using a coding agent or other AI chat syste
In this guide, we show you how to create agentic workflows in the GitHub web interface (github.com), your coding agent, or in VS Code Agent Mode.
+
+
## Creating Agentic Workflows using a Coding Agent
Follow these steps to create an agentic workflow using VSCode or your coding agent.
@@ -45,13 +52,6 @@ After merging the pull request, you can run the workflow to see it in action. Ei
- trigger runs manually from the Actions tab in GitHub.com, or
- use [the `gh aw run` command](/gh-aw/setup/cli/#run) to trigger runs from your terminal.
-
-
## Creating Agentic Workflows with ChatGPT
If you prefer to use ChatGPT to author agentic workflow, you can use the [agentic-chat instructions](https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/agentic-chat.md) with ChatGPT or other conversational AI applications to create clear, actionable task descriptions. Use the button below to copy the full instructions: .
diff --git a/docs/src/content/docs/setup/quick-start.mdx b/docs/src/content/docs/setup/quick-start.mdx
index 9473e1d551..b266f19514 100644
--- a/docs/src/content/docs/setup/quick-start.mdx
+++ b/docs/src/content/docs/setup/quick-start.mdx
@@ -13,6 +13,13 @@ In this guide you will add the automated [**Daily Repo Status Report**](https://
The aim here is **automated AI**: to install something that will run **automatically** every day, in the context of your repository. The workflow will regularly create or update a fresh status report issue in your repository, without any further manual intervention. If you're familiar with GitHub Actions, you will be aware of the power of automation in repositories; this is simply taking that to the next level with AI.
+
+
## Prerequisites
Before installing, ensure you have:
@@ -31,13 +38,6 @@ Install the [GitHub CLI](https://cli.github.com/), then install the GitHub Agent
gh extension install github/gh-aw
```
-
-
> [!TIP]
> If you are encountering authentication issues, use this script,
> ```