From 763833c40ce15824fc208f9003a952f8ab120caf Mon Sep 17 00:00:00 2001
From: DavidKoleczek <45405824+DavidKoleczek@users.noreply.github.com>
Date: Tue, 27 Oct 2026 14:52:25 -0400
Subject: [PATCH] docs: lead the Quickstart with prompts for your coding agent

The Quickstart now asks the coding agent to install the integration skill, so
users start with a prompt instead of a shell command. The npx skills command
moves to a new "Integration skill" subsection under Install.

Generated with Amplifier

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
---
 README.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 590b5922..abc360e4 100644
--- a/README.md
+++ b/README.md
@@ -20,14 +20,11 @@ and give it a task. The agent reasons, acts, and reports back.
 
 ## Quickstart
 
-1. Install the integration skill in your application project. It teaches your coding agent to build on the library:
+1. In your application project, ask your agent:
 
-   ```bash
-   # Add -g for global
-   npx skills add microsoft/amplifier-agent --skill amplifier-agent
-   ```
+   > Install the Amplifier Agent skill from microsoft/amplifier-agent.
 
-2. Ask your coding agent for the AI part of your application:
+2. Ask it for the AI part of your application:
 
    > I'm building [describe your application]. Use Amplifier Agent as its intelligence layer.
 
@@ -48,11 +45,20 @@ We build it once, so each product does not have to build it again.
 - **Let it do the long work.** The agent sends tasks to sub-agents, loads skills when it needs them, and compacts
   history before it fills the context window.
 - **Integrate it easily, with your coding agent too.** A few lines start an agent in Python or TypeScript. An
-  [integration skill](#quickstart) teaches your coding agent to build with the library.
+  [integration skill](#integration-skill) teaches your coding agent to build with the library.
 - **Open.** It is open source under the MIT license, and it is not tied to one model vendor.
 
 ## Install
 
+### Integration skill
+
+The skill teaches your coding agent to build on the library.
+
+```bash
+# Add -g for global
+npx skills add microsoft/amplifier-agent --skill amplifier-agent
+```
+
 ### Python
 
 You need [uv](https://docs.astral.sh/uv/) and Git. If you do not have Python 3.12, 3.13, or 3.14, uv installs it for you.