From 287ccb7ef67ab1ca2a108ad1ab523479aca24e8e Mon Sep 17 00:00:00 2001
From: Rostan Tabet <rtabet@nvidia.com>
Date: Wed, 20 May 2026 12:21:54 +0000
Subject: [PATCH 1/3] Document that the dali-dynamic-mode skill exists

Signed-off-by: Rostan Tabet <rtabet@nvidia.com>
---
 docs/dali_dynamic/overview.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/dali_dynamic/overview.rst b/docs/dali_dynamic/overview.rst
index 03f84b87e32..3d31329a2b5 100644
--- a/docs/dali_dynamic/overview.rst
+++ b/docs/dali_dynamic/overview.rst
@@ -25,6 +25,16 @@ You can also access the :ref:`DALI Pipeline API <pipeline_api_overview>`, which
 graph-based execution model.
 
 
+.. tip::
+   The `dali-dynamic-mode <https://github.com/NVIDIA/skills/blob/main/skills/DALI/dali-dynamic-mode/SKILL.md>`_ skill
+   provides AI agents with guidance on the Dynamic Mode API and best practices. It can be installed as follows:
+
+   .. code-block:: sh
+
+      npx skills add nvidia/skills --skill dali-dynamic-mode
+
+   For more information, see the `NVIDIA/skills <https://github.com/NVIDIA/skills>`_ GitHub repository.
+
 How it works
 ------------
 

From 7be59a71560a42aef1ee3104b15342161fd140b2 Mon Sep 17 00:00:00 2001
From: Rostan Tabet <rtabet@nvidia.com>
Date: Tue, 26 May 2026 09:00:36 +0000
Subject: [PATCH 2/3] Duplicate dynamic mode skill tip in README

Signed-off-by: Rostan Tabet <rtabet@nvidia.com>
---
 README.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.rst b/README.rst
index 60a8093b4e8..554557676ca 100644
--- a/README.rst
+++ b/README.rst
@@ -30,6 +30,16 @@ can easily be retargeted to TensorFlow, PyTorch, and PaddlePaddle.
     :align: center
     :alt: DALI Diagram
 
+.. tip::
+    The `dali-dynamic-mode <https://github.com/NVIDIA/skills/blob/main/skills/DALI/dali-dynamic-mode/SKILL.md>`_ skill
+    provides AI agents with guidance on the Dynamic Mode API and best practices. It can be installed as follows:
+
+    .. code-block:: sh
+
+        npx skills add nvidia/skills --skill dali-dynamic-mode
+
+    For more information, see the `NVIDIA/skills <https://github.com/NVIDIA/skills>`_ GitHub repository.
+
 DALI in action:
 
 .. container:: dali-tabs

From efbc486785cf05e73db9e40a6b956dd69b1cd611 Mon Sep 17 00:00:00 2001
From: Rostan Tabet <rtabet@nvidia.com>
Date: Tue, 26 May 2026 14:39:06 +0000
Subject: [PATCH 3/3] GitHub WAR to properly show the tip box

Signed-off-by: Rostan Tabet <rtabet@nvidia.com>
---
 README.rst | 44 ++++++++++++++++++++++++++++++++++++++------
 1 file changed, 38 insertions(+), 6 deletions(-)

diff --git a/README.rst b/README.rst
index 554557676ca..060ae3ce57f 100644
--- a/README.rst
+++ b/README.rst
@@ -30,15 +30,47 @@ can easily be retargeted to TensorFlow, PyTorch, and PaddlePaddle.
     :align: center
     :alt: DALI Diagram
 
-.. tip::
-    The `dali-dynamic-mode <https://github.com/NVIDIA/skills/blob/main/skills/DALI/dali-dynamic-mode/SKILL.md>`_ skill
-    provides AI agents with guidance on the Dynamic Mode API and best practices. It can be installed as follows:
+.. github display off
 
-    .. code-block:: sh
+.. GitHub discards custom styles when rendering Markdown so it's hard to display a good looking admonition.
+   We can use it to our advantage to show different elements on GitHub and in the documentation.
 
-        npx skills add nvidia/skills --skill dali-dynamic-mode
+.. only:: html
 
-    For more information, see the `NVIDIA/skills <https://github.com/NVIDIA/skills>`_ GitHub repository.
+    .. raw:: html
+
+        <style>
+        .github-only {
+            display: none !important;
+        }
+        </style>
+
+.. raw:: html
+
+    <details class="github-only">
+        <summary><strong>Dynamic Mode Agent Skill</strong></summary>
+
+        <p>
+        The <a href="https://github.com/NVIDIA/skills/blob/main/skills/DALI/dali-dynamic-mode/SKILL.md">dali-dynamic-mode</a>
+        skill provides AI agents with guidance on the Dynamic Mode API and best practices.
+        For more information, see the <a href="https://github.com/NVIDIA/skills">NVIDIA/skills</a> GitHub repository.
+        </p>
+
+    </details>
+
+.. only:: not github
+
+    .. tip::
+        The `dali-dynamic-mode <https://github.com/NVIDIA/skills/blob/main/skills/DALI/dali-dynamic-mode/SKILL.md>`_ skill
+        provides AI agents with guidance on the Dynamic Mode API and best practices. It can be installed as follows:
+
+        .. code-block:: sh
+
+            npx skills add nvidia/skills --skill dali-dynamic-mode
+
+        For more information, see the `NVIDIA/skills <https://github.com/NVIDIA/skills>`_ GitHub repository.
+
+.. github display on
 
 DALI in action: