From 4a0844bdda75ff15c741d53f85bf612477b16938 Mon Sep 17 00:00:00 2001
From: andrei <andreig09@gmail.com>
Date: Mon, 29 Jun 2026 17:55:32 -0300
Subject: [PATCH] Add AI assistance section to user guide. Introduces a new
 docs/guide/ai-assistance.md section referencing JMeter DSL Skills

---
 docs/guide/ai-assistance.md | 12 ++++++++++++
 docs/guide/index.md         |  1 +
 2 files changed, 13 insertions(+)
 create mode 100644 docs/guide/ai-assistance.md

diff --git a/docs/guide/ai-assistance.md b/docs/guide/ai-assistance.md
new file mode 100644
index 00000000..89d0e444
--- /dev/null
+++ b/docs/guide/ai-assistance.md
@@ -0,0 +1,12 @@
+## AI assistance
+
+[JMeter DSL Skills](https://github.com/abstracta/jmeter-dsl-skills) is a set of AI agent skills for JMeter Java DSL that will help you throughout the entire performance testing workflow.
+
+Currently, you can use it to:
+
+- **Write DSL code**: get help generating test plans, samplers, assertions, and more from natural language descriptions
+- **Navigate the documentation**: ask questions about DSL features, configuration options, and best practices and get answers grounded in the DSL docs
+
+In the future, it will also support triggering test executions, analyzing results, and configuring projects — making it a single AI interface for the full performance testing lifecycle.
+
+To get started, follow the setup instructions in the [JMeter DSL Skills repository](https://github.com/abstracta/jmeter-dsl-skills).
diff --git a/docs/guide/index.md b/docs/guide/index.md
index 1c78ffa7..c218601f 100644
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@ -19,6 +19,7 @@ For an intro to JMeter concepts and components, you can check [JMeter official d
 <!-- @include: recorder/index.md -->
 <!-- @include: jmx2dsl.md -->
 <!-- @include: scale/index.md -->
+<!-- @include: ai-assistance.md -->
 <!-- @include: autostop.md -->
 <!-- @include: thread-groups/index.md -->
 <!-- @include: debugging/index.md -->