From 50530641036ed9b95dfb80b1d38dca89025cc48e Mon Sep 17 00:00:00 2001
From: Jeremiah Snee <113928685+jeremiah-snee-openx@users.noreply.github.com>
Date: Wed, 8 Oct 2025 09:06:00 -0500
Subject: [PATCH] Update Contributing Guide

---
 CONTRIBUTING.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8945cea..f18b788 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -135,6 +135,32 @@ items:
     kind: instruction
   - path: chatmodes/my-chatmode.chatmode.md
     kind: chat-mode
+    usage: |
+     recommended # or "optional" if not essential to the workflow
+
+     This chat mode requires the following instructions/prompts/MCPs:
+      - Instruction 1
+      - Prompt 1
+      - MCP 1
+
+     This chat mode is ideal for...
+      - Use case 1
+      - Use case 2
+    
+      Here is an example of how to use it:
+      ```markdown, task-plan.prompt.md
+      ---
+      mode: task-planner
+      title: Plan microsoft fabric realtime intelligence terraform support
+      ---
+      #file: <file including in chat context>
+      Do an action to achieve goal.
+      ```
+
+      To get the best results, consider...
+      - Tip 1
+      - Tip 2
+    
 display:
   ordering: alpha # or "manual" to preserve order above
   show_badge: false # set to true to show collection badge