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 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..67737823027 --- /dev/null +++ b/hugo/content/en/bits_ai/skills_library.md @@ -0,0 +1,129 @@ +--- +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' +--- + +## 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 + +Create a skill directly in the Skills Library, or ask Bits Chat to create one for you. + +### 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. +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. + +### 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: + +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 configuration, select each skill that the agent needs. The agent automatically loads selected skills. + +To invoke a skill explicitly during a conversation, enter 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 for 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. +- `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 is available in Bits Chat, Bits Agent Builder, Slack, and external agents that connect through the Datadog MCP Server. + +## Further reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /bits_ai/bits_chat/ +[2]: /actions/agents/ +[3]: /mcp_server/ +[4]: https://app.datadoghq.com/actions/skills