docs: add EDOT Java v0.1.1 agent-skill callouts (#1004)

* Add agent-skill callouts for EDOT Java setup and migration.

Surface the new v0.1.1 EDOT Java instrument and migrate skills on the canonical task pages.

Co-authored-by: GPT-5 Codex <gpt-5-codex@openai.com>
Made-with: Cursor

* Update migration.md

* Update index.md

* docs: add EDOT Java agent-skill body text

Re-add custom agent-skill descriptions after the callouts were moved to their new locations in setup and migration pages.

Co-authored-by: GPT-5 Codex <gpt-5-codex@openai.com>
Made-with: Cursor

---------

Co-authored-by: GPT-5 Codex <gpt-5-codex@openai.com>

Author: theletterf

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}

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).
+For help with common setup issues, refer to the [EDOT Java troubleshooting guide](docs-content://troubleshoot/ingest/opentelemetry/edot-sdks/java/index.md).