﻿---
title: Agent skill
description: The {agent-skill} directive renders a standardized callout that points readers to an Elastic AI agent skill. It uses a fixed title and description, and...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2856/syntax/agent-skill
---

# Agent skill
The `{agent-skill}` directive renders a standardized callout that points readers to an [Elastic AI agent skill](https://github.com/elastic/agent-skills). It uses a fixed title and description, and includes a "Get the skill" button linking to the skill's URL.

## Usage

<tab-set>
  <tab-item title="Output">
    <agent-skill url="https://github.com/elastic/agent-skills@elasticsearch-esql">
      A skill is available to help AI agents with this topic.
    </agent-skill>
  </tab-item>

  <tab-item title="Markdown">
    ```markdown
    :::{agent-skill}
    :url: https://github.com/elastic/agent-skills@elasticsearch-esql
    :::
    ```
  </tab-item>
</tab-set>


## Properties


| Property | Required | Description                          |
|----------|----------|--------------------------------------|
| `:url:`  | Yes      | Absolute URL to the skill on GitHub. |

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.