From d57407410d00632c522073522935f355769cb775 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 14:16:50 -0400 Subject: [PATCH 01/10] Create Skills Library documentation Added a new Skills Library documentation page outlining how to create and use reusable skills for AI agents in Datadog. --- hugo/content/en/bits_ai/skills_library.md | 105 ++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 hugo/content/en/bits_ai/skills_library.md diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md new file mode 100644 index 00000000000..bf94cc17473 --- /dev/null +++ b/hugo/content/en/bits_ai/skills_library.md @@ -0,0 +1,105 @@ +--- +title: Skills Library +description: Create reusable skills that provide Bits AI and external AI agents with organization-specific domain knowledge and instructions. +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +- link: "/actions/agents/" + tag: "Documentation" + text: "Bits Agent Builder" +- link: "/bits_ai/mcp_server/" + tag: "Documentation" + text: "Datadog MCP Server" +--- + +## Overview + +Use the Skills Library to define reusable domain knowledge and instructions for AI agents. Skills give agents task-specific context without requiring you to repeat the same information in each prompt. + +For example, create a skill that describes an organization's incident response process, service ownership conventions, or requirements for summarizing an investigation. + +Skills work with [Bits Chat][1], [Bits Agent Builder][2], the Datadog app for Slack, and external agents such as Claude Code, Codex, and Cursor that connect through the [Datadog MCP Server][3]. + +## Create a skill + +1. Open the [**Skills Library**][4] in Datadog. +2. Create a skill or import an existing `SKILLS.md` file. +3. Add the domain knowledge and instructions that the agent should follow. +4. Select the skill's visibility: + - **Private**: Keep the skill private. + - **Public**: Share the skill with the Datadog organization. +5. Save the skill. + +Use focused instructions and give the skill a descriptive name. A clear name makes the skill easier to discover and invoke with a slash command. + +## Use a skill in Bits Chat + +To make a skill available to Bits Chat: + +1. Open **Settings** in Bits Chat. +2. Select **Skills**. +3. Enable the skill. + +After you enable a skill, Bits Chat uses it automatically when the skill is relevant to a request. + +Invoke a skill explicitly by entering its slash command in the conversation: + +```text +/my-skill +``` + +You can include additional context in the same message or continue the conversation after invoking the skill. + +## Use a skill in Bits Agent Builder + +In the agent instructions, add each skill that the agent needs. Choose only skills that apply to the agent's intended tasks so that the instructions remain focused. + +During a test conversation, invoke a skill explicitly with its slash command: + +```text +/my-skill +``` + +For more information about creating and testing agents, see [Bits Agent Builder][2]. + +## Use a skill in Slack + +After you connect the Datadog app to Slack, mention `@Datadog` and add the skill's slash command: + +```text +@Datadog /my-skill +``` + +Add any task-specific details after the command. + +## Use skills with an external agent + +External AI agents that connect to the Datadog MCP Server can discover and load skills from the Skills Library. + +The Datadog MCP Server provides the following tools: + +- `list_datadog_skills()`: Lists the skills available to the agent. Agents can also discover available skills through MCP Resources. +- `load_datadog_skill()`: Loads a selected skill into the agent's context. + +A typical external-agent workflow is: + +1. Connect the agent to the Datadog MCP Server. +2. Discover available skills with `list_datadog_skills()` or MCP Resources. +3. Load the skill needed for the task with `load_datadog_skill()`. +4. Ask the agent to complete the task using the loaded instructions and knowledge. + +For connection instructions, see the [Datadog MCP Server][3] documentation. + +## Availability + +The Skills Library supports Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. Bits Investigation does not support skills. + +## Further reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /bits_ai/bits_chat/ +[2]: /actions/agents/ +[3]: /bits_ai/mcp_server/ +[4]: https://app.datadoghq.com/actions/skills From 52a84642fcdeb0764ec95e6f73631bc317b3e5fd Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 14:27:25 -0400 Subject: [PATCH 02/10] Update instructions for using skills in Bits Agent --- hugo/content/en/bits_ai/skills_library.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index bf94cc17473..0c681f6f50c 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -53,9 +53,9 @@ You can include additional context in the same message or continue the conversat ## Use a skill in Bits Agent Builder -In the agent instructions, add each skill that the agent needs. Choose only skills that apply to the agent's intended tasks so that the instructions remain focused. +In the agent configuration, select each skill that the agent needs. The agent automatically loads selected skills. -During a test conversation, invoke a skill explicitly with its slash command: +To invoke a skill explicitly during a conversation, enter its slash command: ```text /my-skill From 63b80f866402594b8d95cdaca77ec55b5b79ef95 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 14:31:26 -0400 Subject: [PATCH 03/10] Enhance skills creation instructions in documentation Added instructions for creating skills in the Skills Library and using Bits Chat. --- hugo/content/en/bits_ai/skills_library.md | 24 +++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index 0c681f6f50c..50e97c8c4b4 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -23,6 +23,10 @@ Skills work with [Bits Chat][1], [Bits Agent Builder][2], the Datadog app for Sl ## Create a skill +Create a skill in the Skills Library or by asking Bits Chat. + +### Create a skill in the Skills Library + 1. Open the [**Skills Library**][4] in Datadog. 2. Create a skill or import an existing `SKILLS.md` file. 3. Add the domain knowledge and instructions that the agent should follow. @@ -33,6 +37,26 @@ Skills work with [Bits Chat][1], [Bits Agent Builder][2], the Datadog app for Sl Use focused instructions and give the skill a descriptive name. A clear name makes the skill easier to discover and invoke with a slash command. +### Create a skill with Bits Chat + +Ask Bits Chat to create a skill: + +```text +Create a new Skills Library skill +``` + +To create a skill from the context in an existing Bits Chat conversation, enter: + +```text +Turn this conversation into a skill +``` + +You can also create a skill from an existing Slack thread. In the thread, enter: + +```text +@Datadog turn this conversation into a skill +``` + ## Use a skill in Bits Chat To make a skill available to Bits Chat: From 80a6d9aa5db402ea5224189f6059fb8913af5c81 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 14:49:41 -0400 Subject: [PATCH 04/10] Update link for Datadog MCP Server --- hugo/content/en/bits_ai/skills_library.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index 50e97c8c4b4..1ecd0f5e4e8 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -8,7 +8,7 @@ further_reading: - link: "/actions/agents/" tag: "Documentation" text: "Bits Agent Builder" -- link: "/bits_ai/mcp_server/" +- link: "/mcp_server/" tag: "Documentation" text: "Datadog MCP Server" --- @@ -125,5 +125,5 @@ The Skills Library supports Bits Chat, Bits Agent Builder, Slack, and external a [1]: /bits_ai/bits_chat/ [2]: /actions/agents/ -[3]: /bits_ai/mcp_server/ +[3]: /mcp_server/ [4]: https://app.datadoghq.com/actions/skills From b79c1eebdf5de5bd45c1057488d24a70c5e787ee Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:26:22 -0400 Subject: [PATCH 05/10] add main nav items --- hugo/config/_default/menus/main.en.yaml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 4f7486a03f5..ab1baab74f9 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -1610,6 +1610,11 @@ menu: identifier: bits_data_analysis parent: bits_ai weight: 8 + - name: Skills Library + url: bits_ai/skills_library + identifier: bits_ai_skills_library + parent: bits_ai + weight: 9 - name: Dashboards url: dashboards/ pre: dashboard From 7e183ec09edef6b057a6407985066673b7bdbd1a Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:29:02 -0400 Subject: [PATCH 06/10] remove bits investigation mention --- hugo/content/en/bits_ai/skills_library.md | 24 +++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index 1ecd0f5e4e8..f25018d2039 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -2,15 +2,15 @@ title: Skills Library description: Create reusable skills that provide Bits AI and external AI agents with organization-specific domain knowledge and instructions. further_reading: -- link: "/bits_ai/bits_chat/" - tag: "Documentation" - text: "Bits Chat" -- link: "/actions/agents/" - tag: "Documentation" - text: "Bits Agent Builder" -- link: "/mcp_server/" - tag: "Documentation" - text: "Datadog MCP Server" + - link: '/bits_ai/bits_chat/' + tag: 'Documentation' + text: 'Bits Chat' + - link: '/actions/agents/' + tag: 'Documentation' + text: 'Bits Agent Builder' + - link: '/mcp_server/' + tag: 'Documentation' + text: 'Datadog MCP Server' --- ## Overview @@ -31,8 +31,8 @@ Create a skill in the Skills Library or by asking Bits Chat. 2. Create a skill or import an existing `SKILLS.md` file. 3. Add the domain knowledge and instructions that the agent should follow. 4. Select the skill's visibility: - - **Private**: Keep the skill private. - - **Public**: Share the skill with the Datadog organization. + - **Private**: Keep the skill private. + - **Public**: Share the skill with the Datadog organization. 5. Save the skill. Use focused instructions and give the skill a descriptive name. A clear name makes the skill easier to discover and invoke with a slash command. @@ -117,7 +117,7 @@ For connection instructions, see the [Datadog MCP Server][3] documentation. ## Availability -The Skills Library supports Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. Bits Investigation does not support skills. +The Skills Library is supported Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. ## Further reading From c13e9567464a10429042716d33cac40069caf9f5 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:39:54 -0400 Subject: [PATCH 07/10] Update hugo/content/en/bits_ai/skills_library.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- hugo/content/en/bits_ai/skills_library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index f25018d2039..a3dbaeb6beb 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -23,7 +23,7 @@ Skills work with [Bits Chat][1], [Bits Agent Builder][2], the Datadog app for Sl ## Create a skill -Create a skill in the Skills Library or by asking Bits Chat. +Create a skill directly in the Skills Library, or ask Bits Chat to create one for you. ### Create a skill in the Skills Library From 03b7d0838abf1905d4fbec57aa363c693d8064a7 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:40:06 -0400 Subject: [PATCH 08/10] Update hugo/content/en/bits_ai/skills_library.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- hugo/content/en/bits_ai/skills_library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index a3dbaeb6beb..9300cd2d662 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -117,7 +117,7 @@ For connection instructions, see the [Datadog MCP Server][3] documentation. ## Availability -The Skills Library is supported Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. +The Skills Library is available in Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. ## Further reading From 50f70b869bcfc9d60fc3ebbc3e88b8471a47d1a0 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:40:48 -0400 Subject: [PATCH 09/10] Update hugo/content/en/bits_ai/skills_library.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- hugo/content/en/bits_ai/skills_library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index 9300cd2d662..22cf799eeb0 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -103,7 +103,7 @@ External AI agents that connect to the Datadog MCP Server can discover and load The Datadog MCP Server provides the following tools: -- `list_datadog_skills()`: Lists the skills available to the agent. Agents can also discover available skills through MCP Resources. +- `list_datadog_skills()`: Lists the skills available to the agent. - `load_datadog_skill()`: Loads a selected skill into the agent's context. A typical external-agent workflow is: From 53163bba3a9da1482a9b4c639fd66c5ad5bf6f27 Mon Sep 17 00:00:00 2001 From: Kevin Gallardo Date: Fri, 4 Sep 2026 15:41:40 -0400 Subject: [PATCH 10/10] dd slack --- hugo/content/en/bits_ai/skills_library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/skills_library.md b/hugo/content/en/bits_ai/skills_library.md index 22cf799eeb0..67737823027 100644 --- a/hugo/content/en/bits_ai/skills_library.md +++ b/hugo/content/en/bits_ai/skills_library.md @@ -89,7 +89,7 @@ For more information about creating and testing agents, see [Bits Agent Builder] ## Use a skill in Slack -After you connect the Datadog app to Slack, mention `@Datadog` and add the skill's slash command: +After you connect the Datadog app for Slack, mention `@Datadog` and add the skill's slash command: ```text @Datadog /my-skill