Loading

AI agent skills for Elastic

The elastic/agent-skills repository provides official, open-source skill packages that help AI coding agents work with the Elastic stack. Built on the Agent Skills open standard, they give agents like Claude Code, Cursor, GitHub Copilot, and others the specialized knowledge they need to perform Elastic-specific tasks more accurately and efficiently.

Skills cover areas such as interacting with Elasticsearch APIs, building Kibana dashboards, configuring Fleet policies, and working with Observability and Elastic Security workflows.

AI agent skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge. Each skill is a self-contained folder with a SKILL.md file containing metadata and instructions.

Agents discover available skills at startup by reading their name and description fields, then load full instructions on demand when a matching task is detected.

This approach keeps agents fast by default while giving them access to deep, procedural knowledge when needed.

For more background on the standard, refer to agentskills.io.

Skills in the elastic/agent-skills repository focus on Elastic products and the Elastic stack:

  • Interacting with Elasticsearch APIs (search, indexing, cluster management).
  • Building and managing Kibana dashboards, saved objects, and visualizations.
  • Configuring Fleet policies, Elastic Agent integrations, and Beats pipelines.
  • Patterns for Observability, Elastic Security, and APM workflows.

You can install Elastic skills using the skills CLI with npx, or by cloning the elastic/agent-skills repository and running the bundled installer script. The npx method requires Node.js with npx available in your environment.

The fastest way to install skills is with the skills CLI. Run the following command to launch an interactive prompt where you can select skills and target agents:

npx skills add elastic/agent-skills
		

Install a specific skill by name:

npx skills add elastic/agent-skills --skill elasticsearch-esql
		

Or use the @ shorthand to specify the skill directly as repo@skill (equivalent to --skill):

npx skills add elastic/agent-skills@elasticsearch-esql
		

Install to specific agents:

npx skills add elastic/agent-skills -a cursor -a claude-code
		

List available skills without installing:

npx skills add elastic/agent-skills --list
		

Install all skills to all agents without prompts:

npx skills add elastic/agent-skills --all
		
Flag Description
-a, --agent Target specific agents.
-s, --skill Install specific skills by name.
-g, --global Install to user home instead of project directory.
-y, --yes Skip confirmation prompts.
--all Install all skills to all agents without prompts.
--list List available skills without installing.

If you prefer to work from a local checkout, or your environment does not have Node.js or npx, clone the repository and use the bundled bash installer:

git clone https://github.com/elastic/agent-skills.git
cd agent-skills
./scripts/install-skills.sh add -a <agent>
		

The script requires bash 3.2+ and standard Unix utilities (awk, find, cp, rm, mkdir).

Flag Description
-a, --agent Target agent (repeatable).
-s, --skill Install specific skills by name.
-f, --force Overwrite already-installed skills.
-y, --yes Skip confirmation prompts.

The following AI coding agents are compatible with the Agent Skills format:

Agent Install directory
Claude Code .claude/skills
Cursor .agents/skills
Codex .agents/skills
OpenCode .agents/skills
Windsurf .windsurf/skills
Roo .roo/skills
Cline .agents/skills
GitHub Copilot .agents/skills
Gemini CLI .agents/skills

Skills are copied into your project or home directory at install time. When the repository is updated with new instructions, bug fixes, or additional resources, those changes are not automatically synced to your local copies.

The update process depends on how the skills were installed (npx or a local clone).

Check whether any installed skills have changed upstream:

npx skills check
		

Pull the latest versions of all installed skills:

npx skills update
		
Tip

The default npx installation uses symlinks, so every agent points to a single canonical copy. Updating once refreshes all agents at the same time.

Re-run the installer with --force to overwrite existing skills:

git pull
./scripts/install-skills.sh add -a <agent> --force
		

Without --force, the script skips skills that are already installed.

Found a problem or have a suggestion? Open an issue on the elastic/agent-skills repository.