Knowledge Base

Latest Dynatrace
App
3-min read
Published Oct 29, 2026

Knowledge Base allows you to view, create, and manage the skills that Dynatrace Intelligence uses to analyze the data in your environment.

Dynatrace apps already ship skills that guide Dynatrace Assist through common analysis tasks. These skills are generic, so they can't cover knowledge that's specific to your organization, such as custom error codes, business terminology, or how to interpret your domain data. With Knowledge Base, you can add your own skills to teach Dynatrace Assist how to understand this data.

Permissions

The following table describes the required permissions.

To view and manage skills in Knowledge Base, you need permissions to read, write, and delete documents:

document:documents:read
document:documents:write
document:documents:delete

Get started

Skills overview

Knowledge Base lists all the skills available in your environment in a table, complete with additional information such as:

Name: the name of the skill.
Owner: the owner of the skill.
- For ready-made skills shipped with the Dynatrace apps, the column shows the name of the app.
- For custom skills created by you or other users in your environment, the column shows the name of the person who created the skill.
Created: the date when the skill was created.
Modified: the date when the skill was last modified.
Enabled: the status of the skill (enabled or disabled). Ready-made skills are enabled by default and can't be disabled. You can use this column to enable or disable custom skills.

Skills come from two sources:

Ready-made skills: skills shipped with Dynatrace apps, such as AI Observability, or with extensions. You can view and download ready-made skills, but you can't edit, disable, or delete them.
Custom skills: skills created or uploaded by users in your environment. You can view, edit, download, disable, and delete your skills, but you can't manage custom skills that belong to another user.
Any custom skill is automatically visible to everyone in the environment upon creation.

Skill search and filtering

You can quickly filter the table:

All: All skills available to you.
Owned by me: Skills owned by you.
Ready-made: Skills shipped with Dynatrace apps.

You can also:

Search skills by name: to do so, enter the skill name (partial or full) into the Search by name field
Search and filter skills by the owner: to do so, select Owned by anyone and select the owner of the skill you want to find.
Search and filter skills by the app or extension: to do so
1. Go to the Ready-made tab.
2. Select All ready-made, then select Ready-made by and choose between apps or extensions to filter shipped skills.
Use Columns to hide or add existing columns. By default, all columns are visible.

View a skill

You can open the skill page and view skill details by selecting a skill name in the Name column. The skill page is divided into general information on the left and the skill instructions on the right.

General information on the left shows:

Skill name.
Owner of the skill or the app shipping the skill.
Short description of the skill.
The main instruction file, SKILL.md, with its size and dates (Skill).
A list of references used by the skill (References). A reference is only used if SKILL.md mentions it. You can download references one by one or save all of them as a .zip file. For your own skills, you can also rename or delete existing references and add new ones.
- You can view the reference file content by selecting the name of the reference. In this case, the file content is shown on the right side instead of skill instructions.

The right side shows the content of SKILL.md.

You can use the skill page to Edit, Enable or Disable, Download, or Delete the skills you own. For ready-made and custom skills created by others, you can only download a skill. You can access additional options by selecting .

Create a skill

You can create a skill from a template or upload an existing one.

Create a skill using a template

To create a new skill using a template

In Knowledge Base, select New skill.
In the file on the right side, fill in the frontmatter:
- Replace name: your-skill-name with a unique name for your skill (for example, name: analyze-cpu-load). You can use only lowercase letters, numbers, and hyphens.
  If you try to use an already existing name, you'll receive the error message: A skill named "<your-skill-name>" already exists. Choose a different name in the SKILL.md frontmatter and try again.
  
  You can't change the skill name after the skill is created.
- In description: >, write one to three sentences about what this skill does and how it can help.
Fill in the rest of the template according to the instructions.
Select Save to save your changes.

After saving a skill, you can add reference files with additional context, such as lookup tables or detailed explanations. You can do so by uploading a reference or writing one from scratch.

To upload a reference, select Add reference > Upload and add an existing .md reference file with a unique name.

To write a new reference

Select Add reference > Write.
In Add reference filename, enter a meaningful name for your reference, then select Continue.
Fill in the template on the right according to the instructions.
Select Save to save your changes.

Upload a skill

In Knowledge Base, select Upload.
You automatically become the owner of the skill you upload. This way, you can customize a ready-made skill or adjust a custom skill created by someone else. Before uploading, change name: in the SKILL.md frontmatter to a new, unique name. Keep in mind that you can't change the skill name after the skill is created.
Select a SKILL.md file, or a .zip file that contains SKILL.md and up to 10 references. Ensure that the name of the uploaded skill is unique, otherwise you'll receive the error message: A skill named "<your-skill-name>" already exists. Choose a different name in the SKILL.md frontmatter and try again.

After you upload the skill, you're automatically redirected to the skill page. From there, you can further edit the skill or enrich it with references. To add a reference, you can upload an existing reference or write one from scratch.

To upload a reference, select Add reference > Upload and add an existing .md reference file with a unique name.

To write a new reference

Select Add reference > Write.
In Add reference filename, enter a meaningful name for your reference and select Continue.
Fill in the template on the right according to the instructions.
Select Save to save your changes.

Edit a skill

You can only make changes to the skills you own. To edit a skill

Open your custom skill by selecting a skill name in the Name column.
Select Edit.
Change the description or instructions, add new reference files, or manage existing references by changing or deleting them. You can't change the skill name after the skill is created.
Select Save to save your changes.

Enable or disable a skill

Newly created skills are enabled by default. If you want to disable a skill, you can:

Go to the main Knowledge Base page and turn off the switch in the Enabled column next to your skill.
Go to the skill page and select > Disable skill.

When you disable a skill, Dynatrace Assist can no longer use it, and other users in your environment can't see it. The skill stays in your environment, so you can enable it again at any time, unless another enabled skill uses the same name in the meantime.

How Dynatrace Assist uses skills

When you send a prompt, agentic Dynatrace Assist checks the descriptions of all enabled skills. If a skill description matches your request, Dynatrace Assist reads the skill and its reference files and follows the instructions in its response.

For more information about the sources Dynatrace Assist uses, see Sources used for response generation.

Custom skills support in other apps

Custom skills created in Knowledge Base Knowledge Base are currently only available in Dynatrace Assist. They aren't recognized by or visible to agentic actions in Workflows, so they can't affect new or existing automations. Ready-made skills shipped out-of-the-box with Dynatrace apps and extensions work in Workflows as usual.

Use cases

You can use Knowledge Base to:

Teach Dynatrace Assist your organization's terminology, error codes, and data conventions.
Define how Dynatrace Assist should analyze specific types of data in your environment.
Inspect the ready-made skills to understand how Dynatrace Assist approaches an analysis.
Add custom skills to improve Dynatrace Assist responses and accuracy.
Share skills between teams within or across the environments.

Knowledge Base

Latest Dynatrace
App
3-min read
Published Oct 29, 2026

Knowledge Base allows you to view, create, and manage the skills that Dynatrace Intelligence uses to analyze the data in your environment.

Permissions

The following table describes the required permissions.

To view and manage skills in Knowledge Base, you need permissions to read, write, and delete documents:

document:documents:read
document:documents:write
document:documents:delete

Get started

Skills overview

Knowledge Base lists all the skills available in your environment in a table, complete with additional information such as:

Name: the name of the skill.
Owner: the owner of the skill.
- For ready-made skills shipped with the Dynatrace apps, the column shows the name of the app.
- For custom skills created by you or other users in your environment, the column shows the name of the person who created the skill.
Created: the date when the skill was created.
Modified: the date when the skill was last modified.
Enabled: the status of the skill (enabled or disabled). Ready-made skills are enabled by default and can't be disabled. You can use this column to enable or disable custom skills.

Skills come from two sources:

Ready-made skills: skills shipped with Dynatrace apps, such as AI Observability, or with extensions. You can view and download ready-made skills, but you can't edit, disable, or delete them.
Custom skills: skills created or uploaded by users in your environment. You can view, edit, download, disable, and delete your skills, but you can't manage custom skills that belong to another user.
Any custom skill is automatically visible to everyone in the environment upon creation.

Skill search and filtering

You can quickly filter the table:

All: All skills available to you.
Owned by me: Skills owned by you.
Ready-made: Skills shipped with Dynatrace apps.

You can also:

Search skills by name: to do so, enter the skill name (partial or full) into the Search by name field
Search and filter skills by the owner: to do so, select Owned by anyone and select the owner of the skill you want to find.
Search and filter skills by the app or extension: to do so
1. Go to the Ready-made tab.
2. Select All ready-made, then select Ready-made by and choose between apps or extensions to filter shipped skills.
Use Columns to hide or add existing columns. By default, all columns are visible.

View a skill

General information on the left shows:

Skill name.
Owner of the skill or the app shipping the skill.
Short description of the skill.
The main instruction file, SKILL.md, with its size and dates (Skill).
A list of references used by the skill (References). A reference is only used if SKILL.md mentions it. You can download references one by one or save all of them as a .zip file. For your own skills, you can also rename or delete existing references and add new ones.
- You can view the reference file content by selecting the name of the reference. In this case, the file content is shown on the right side instead of skill instructions.

The right side shows the content of SKILL.md.

Create a skill

You can create a skill from a template or upload an existing one.

Create a skill using a template

To create a new skill using a template

In Knowledge Base, select New skill.
In the file on the right side, fill in the frontmatter:
- Replace name: your-skill-name with a unique name for your skill (for example, name: analyze-cpu-load). You can use only lowercase letters, numbers, and hyphens.
  If you try to use an already existing name, you'll receive the error message: A skill named "<your-skill-name>" already exists. Choose a different name in the SKILL.md frontmatter and try again.
  
  You can't change the skill name after the skill is created.
- In description: >, write one to three sentences about what this skill does and how it can help.
Fill in the rest of the template according to the instructions.
Select Save to save your changes.

After saving a skill, you can add reference files with additional context, such as lookup tables or detailed explanations. You can do so by uploading a reference or writing one from scratch.

To upload a reference, select Add reference > Upload and add an existing .md reference file with a unique name.

To write a new reference

Select Add reference > Write.
In Add reference filename, enter a meaningful name for your reference, then select Continue.
Fill in the template on the right according to the instructions.
Select Save to save your changes.

Upload a skill

In Knowledge Base, select Upload.
You automatically become the owner of the skill you upload. This way, you can customize a ready-made skill or adjust a custom skill created by someone else. Before uploading, change name: in the SKILL.md frontmatter to a new, unique name. Keep in mind that you can't change the skill name after the skill is created.
Select a SKILL.md file, or a .zip file that contains SKILL.md and up to 10 references. Ensure that the name of the uploaded skill is unique, otherwise you'll receive the error message: A skill named "<your-skill-name>" already exists. Choose a different name in the SKILL.md frontmatter and try again.

To upload a reference, select Add reference > Upload and add an existing .md reference file with a unique name.

To write a new reference

Select Add reference > Write.
In Add reference filename, enter a meaningful name for your reference and select Continue.
Fill in the template on the right according to the instructions.
Select Save to save your changes.

Edit a skill

You can only make changes to the skills you own. To edit a skill

Open your custom skill by selecting a skill name in the Name column.
Select Edit.
Change the description or instructions, add new reference files, or manage existing references by changing or deleting them. You can't change the skill name after the skill is created.
Select Save to save your changes.

Enable or disable a skill

Newly created skills are enabled by default. If you want to disable a skill, you can:

Go to the main Knowledge Base page and turn off the switch in the Enabled column next to your skill.
Go to the skill page and select > Disable skill.

How Dynatrace Assist uses skills

For more information about the sources Dynatrace Assist uses, see Sources used for response generation.

Custom skills support in other apps

Use cases

You can use Knowledge Base to:

Teach Dynatrace Assist your organization's terminology, error codes, and data conventions.
Define how Dynatrace Assist should analyze specific types of data in your environment.
Inspect the ready-made skills to understand how Dynatrace Assist approaches an analysis.
Add custom skills to improve Dynatrace Assist responses and accuracy.
Share skills between teams within or across the environments.

Knowledge Base

Permissions

Get started

Skills overview

Skill search and filtering

View a skill

Create a skill

Create a skill using a template

Upload a skill

Edit a skill

Enable or disable a skill

How Dynatrace Assist uses skills

Use cases

Related topics

Knowledge Base

Permissions

Get started

Skills overview

Skill search and filtering

View a skill

Create a skill

Create a skill using a template

Upload a skill

Edit a skill

Enable or disable a skill

How Dynatrace Assist uses skills

Use cases

Related topics