Agent skill

The {agent-skill} directive renders a standardized callout that points readers to an Elastic AI agent skill. It includes a "Get the skill" button linking to the skill's URL.

By default, the directive renders a standard description:

:::{agent-skill}
:url: https://github.com/elastic/agent-skills@elasticsearch-esql
:::
		

You can also provide custom body text to clarify the scope of the skill:

:::{agent-skill}
:url: https://github.com/elastic/agent-skills@elasticsearch-esql

This skill helps agents write and optimize ES|QL queries.
:::
		

The :url: property must be an absolute URL. Relative paths are not accepted, and the directive will emit a build error if the URL is missing or relative.