diff --git a/docs/reference/edot-java/migration.md b/docs/reference/edot-java/migration.md
index e11f06dd..5c05668e 100644
--- a/docs/reference/edot-java/migration.md
+++ b/docs/reference/edot-java/migration.md
@@ -25,6 +25,12 @@ Compared to the Elastic {{product.apm}} Java agent, the {{edot}} Java presents a
 
 ## Migration steps
 
+:::{agent-skill}
+:url: https://github.com/elastic/agent-skills/tree/main/skills/observability/edot-java-migrate
+
+Use this skill to migrate from the Elastic APM Java agent to EDOT Java.
+:::
+
 Follow these steps to migrate from the legacy Elastic {{product.apm}} Java agent to the {{edot}} Java.
 
 ::::::{stepper}
diff --git a/docs/reference/edot-java/setup/index.md b/docs/reference/edot-java/setup/index.md
index 96d12d26..7bf50994 100644
--- a/docs/reference/edot-java/setup/index.md
+++ b/docs/reference/edot-java/setup/index.md
@@ -33,6 +33,12 @@ For environments where modifying the JVM arguments or configuration is not possi
 
 Follow the following Java setup guide for all other environments.
 
+:::{agent-skill}
+:url: https://github.com/elastic/agent-skills/tree/main/skills/observability/edot-java-instrument
+
+Use this skill to instrument Java services with EDOT for tracing, metrics, and logs.
+:::
+
 ## Download the agent
 
 You can download the latest release version of the EDOT Java agent from [![Maven Central](https://img.shields.io/maven-central/v/co.elastic.otel/elastic-otel-javaagent?label=elastic-otel-javaagent&style=for-the-badge)](https://mvnrepository.com/artifact/co.elastic.otel/elastic-otel-javaagent/latest)
@@ -96,4 +102,4 @@ For applications deployed with Kubernetes, use the [OpenTelemetry Operator](/ref
 
 ## Troubleshooting
 
-For help with common setup issues, refer to the [EDOT Java troubleshooting guide](docs-content://troubleshoot/ingest/opentelemetry/edot-sdks/java/index.md).
\ No newline at end of file
+For help with common setup issues, refer to the [EDOT Java troubleshooting guide](docs-content://troubleshoot/ingest/opentelemetry/edot-sdks/java/index.md).