docs: add EDOT Python v0.1.1 agent-skill callouts (#507)

theletterf · GPT-5 Codex · web-flow · commit c3abe98c9017 · 2026-03-16T15:30:18.000+01:00
* Add agent-skill callouts for EDOT Python setup and migration.

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

Co-authored-by: GPT-5 Codex &lt;gpt-5-codex@openai.com&gt;
Made-with: Cursor

* Update migration.md

* Update index.md

* docs: add EDOT Python 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 &lt;gpt-5-codex@openai.com&gt;
Made-with: Cursor

---------

Co-authored-by: GPT-5 Codex &lt;gpt-5-codex@openai.com&gt;
diff --git a/docs/reference/edot-python/migration.md b/docs/reference/edot-python/migration.md
@@ -28,6 +28,12 @@ Follow these steps to migrate:
 2. Migrate any usage of Elastic {{product.apm-agent-python}} API to manual instrumentation with OpenTelemetry API in the application source code.
 3. Follow the [setup documentation](setup/index.md) on to install and configure EDOT Python.
 
+:::{agent-skill}
+:url: https://github.com/elastic/agent-skills/tree/main/skills/observability/edot-python-migrate
+
+Use this skill to migrate from the Elastic APM Python agent to EDOT Python.
+:::
+
 ## Configuration mapping
 
 The following are Elastic {{product.apm}} Python agent settings that you can migrate to EDOT Python.
diff --git a/docs/reference/edot-python/setup/index.md b/docs/reference/edot-python/setup/index.md
@@ -19,6 +19,12 @@ Learn how to set up the {{edot}} (EDOT) Python in various environments, includin
 
 Follow these steps to get started.
 
+:::{agent-skill}
+:url: https://github.com/elastic/agent-skills/tree/main/skills/observability/edot-python-instrument
+
+Use this skill to instrument Python services with EDOT for tracing, metrics, and logs.
+:::
+
 :::{warning}
 Avoid using the Python SDK alongside any other APM agent, including Elastic APM agents. Running multiple agents in the same application process may lead to conflicting instrumentation, duplicate telemetry, or other unexpected behavior.
 :::
@@ -82,4 +88,4 @@ There might be no trace data to visualize unless you have invoked your applicati
 
 ## Troubleshooting
 
-For help with common setup issues, refer to the [EDOT Python troubleshooting guide](docs-content://troubleshoot/ingest/opentelemetry/edot-sdks/python/index.md).
+For help with common setup issues, refer to the [EDOT Python troubleshooting guide](docs-content://troubleshoot/ingest/opentelemetry/edot-sdks/python/index.md).
