Merge pull request #9533 from microsoft/ntrogh/customization-tutorial

Update Copilot customization content

Author: ntrogh

docs/copilot/customization/prompt-files.md

@@ -23,7 +23,7 @@ Use prompt files to:
 * Override default behavior of a custom agent, such as creating a minimal implementation plan or generating mockups for API calls
 
 > [!TIP]
-> **Prompt files, agents, or skills?** All three can be invoked as slash commands. Use prompt files for lightweight, single-task prompts. Use [custom agents](/docs/copilot/customization/custom-agents.md) when you need a persistent persona with its own tool restrictions and handoffs. Use [agent skills](/docs/copilot/customization/agent-skills.md) when you need a portable, multi-file capability with scripts and resources.
+> **Prompt files, agents, or skills?** Use prompt files for lightweight, single-task prompts. Use [custom agents](/docs/copilot/customization/custom-agents.md) when you need a persistent persona with its own tool restrictions and handoffs. Use [agent skills](/docs/copilot/customization/agent-skills.md) when you need a portable, multi-file capability with scripts and resources.
 
 > [!TIP]
 > Use the [Chat Customizations editor](/docs/copilot/customization/overview.md#chat-customizations-editor) (Preview) to discover, create, and manage all your chat customizations in one place. Run **Chat: Open Chat Customizations** from the Command Palette.

docs/copilot/guides/customize-copilot-guide.md

@@ -166,17 +166,19 @@ MCP servers extend the AI with access to external tools and services. Add one fr
 
 1. Open the Extensions view (`kb(workbench.view.extensions)`) and type `@mcp` in the search field.
 
-1. Browse the available MCP servers and select **Install** for one that fits your workflow (for example, **Playwright** for browser automation or **GitHub** for repository operations).
+1. Browse the available MCP servers and select **Install** for **MarkItDown**, a tool that converts files like PDFs, Word documents, and spreadsheets to Markdown.
 
 1. When prompted, confirm that you trust the server.
 
-1. Open the Chat view and enter a prompt that uses the server's tools. For example, with Playwright installed:
+1. Select the **Configure Tools** button in the chat input and then enable the MarkItDown tool to allow the agent to use it.
+
+1. Open the Chat view and enter a prompt that uses the server's tools. For example, with MarkItDown installed:
 
     ```prompt
-    Navigate to my app at localhost:3000 and take a screenshot of the homepage.
+    Convert the file report.pdf in my workspace to Markdown.
     ```
 
-**Verify it works**: Copilot should invoke the MCP server tools and return results. Select the **Configure Tools** button in the chat input to see the available tools from the server.
+**Verify it works**: The agent should invoke the MarkItDown tool and return the file content as Markdown.
 
 > [!TIP]
 > You can also configure MCP servers manually by editing the `.vscode/mcp.json` file. Learn more in [Add and manage MCP servers](/docs/copilot/customization/mcp-servers.md).