From ff990b05025611d8c9815d158df428d510ead089 Mon Sep 17 00:00:00 2001
From: Anthony Giuliano <113943282+agiuliano-square@users.noreply.github.com>
Date: Tue, 22 Jul 2025 07:08:33 -0400
Subject: [PATCH] Add YouTube video embed to using-goosehints.md (#3560)

---
 documentation/docs/guides/using-goosehints.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/documentation/docs/guides/using-goosehints.md b/documentation/docs/guides/using-goosehints.md
index 9b69bcdf..c85a69a4 100644
--- a/documentation/docs/guides/using-goosehints.md
+++ b/documentation/docs/guides/using-goosehints.md
@@ -8,9 +8,20 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import { FolderKey } from 'lucide-react';
 
-
 `.goosehints` is a text file used to provide additional context about your project and improve the communication with Goose. The use of `goosehints` ensures that Goose understands your requirements better and can execute tasks more effectively.
 
+<details>
+  <summary>Goose Hints Video Walkthrough</summary>
+  <iframe
+  class="aspect-ratio"
+  src="https://www.youtube.com/embed/kWXJC5p0608"
+  title="Goose Hints"
+  frameBorder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+  ></iframe>
+</details>
+
 :::info Developer extension required
 To make use of the hints file, you need to have the `Developer` extension [enabled](/docs/getting-started/using-extensions).