diff --git a/content/docs/api-and-data-platform/features/agent-skill.mdx b/content/docs/api-and-data-platform/features/agent-skill.mdx
index 0c099b901..51a6fd30d 100644
--- a/content/docs/api-and-data-platform/features/agent-skill.mdx
+++ b/content/docs/api-and-data-platform/features/agent-skill.mdx
@@ -33,6 +33,7 @@ The skill uses a progressive disclosure model: the frontmatter is always loaded
 ## Install [#install]
 
 import AutoInstall from "@/components-mdx/get-started/auto-install.mdx";
+import { FaqPreview } from "@/components/faq/FaqPreview";
 
 <AutoInstall />
 
@@ -42,6 +43,10 @@ Once installed, you can prompt your agent with what you want to do. A couple of
 - *Create a dataset called "edge-cases" and add these 3 items to it*
 - *Migrate the system prompt in src/agent.ts to Langfuse prompt management*
 
+## FAQ
+
+<FaqPreview tags={["agent-skill"]} />
+
 ## Resources [#resources]
 
 - [Langfuse Skills on GitHub](https://github.com/langfuse/skills)
diff --git a/content/docs/observability/get-started.mdx b/content/docs/observability/get-started.mdx
index a40fa09e9..35c833c00 100644
--- a/content/docs/observability/get-started.mdx
+++ b/content/docs/observability/get-started.mdx
@@ -107,6 +107,8 @@ Add tracing to this application with Langfuse following best practices.
 
 </Tabs>
 
+[What will the coding agent do?](/faq/all/agentic-onboarding-with-coding-agents)
+
 </div>
 
 ## Manual installation [#manual-installation]
diff --git a/content/docs/prompt-management/get-started.mdx b/content/docs/prompt-management/get-started.mdx
index 22f1d1c00..6906c2c94 100644
--- a/content/docs/prompt-management/get-started.mdx
+++ b/content/docs/prompt-management/get-started.mdx
@@ -101,6 +101,8 @@ Migrate the prompts in this codebase to Langfuse.
 
 </Tabs>
 
+[What will the coding agent do?](/faq/all/agentic-onboarding-with-coding-agents)
+
 </div>
 
 ## Manual installation [#manual-installation]
diff --git a/content/faq/all/agentic-onboarding-with-coding-agents.mdx b/content/faq/all/agentic-onboarding-with-coding-agents.mdx
new file mode 100644
index 000000000..9a5dcafac
--- /dev/null
+++ b/content/faq/all/agentic-onboarding-with-coding-agents.mdx
@@ -0,0 +1,58 @@
+---
+title: What happens when I use Langfuse's agentic onboarding with a coding agent?
+description: Learn what Langfuse's coding-agent onboarding does automatically for tracing and prompt management.
+tags: [agent-skill, observability-get-started, prompt-management-get-started]
+---
+
+# What happens when I use Langfuse's agentic onboarding with a coding agent?
+
+It is not just pasting boilerplate into your repo.
+
+When you use Langfuse's agentic onboarding with the [Langfuse Agent Skill](/docs/api-and-data-platform/features/agent-skill) or the Cursor plugin that bundles it, the coding agent first inspects your codebase and then chooses the Langfuse workflow that fits what it found.
+
+## For tracing
+
+If you ask the agent to instrument your app, it will typically:
+
+- Detect which LLM libraries or frameworks you already use, such as OpenAI, Anthropic, LangChain, or other supported integrations
+- Prefer the matching Langfuse integration instead of falling back to generic manual instrumentation
+- Add the required imports, environment-variable usage, and setup code
+- Refactor existing LLM calls so they are traced with the right integration pattern
+- Keep the integration close to your current code instead of rewriting the whole flow
+
+Typical prompt:
+
+```txt
+Add tracing to this application with Langfuse following best practices.
+```
+
+## For prompt management
+
+If you ask the agent to work with prompts, it can:
+
+- Create a prompt in Langfuse with the variables you describe
+- Migrate hardcoded prompts from your codebase into Langfuse
+- Replace inline prompt strings with fetched prompts in application code
+- Fetch a specific prompt version or label, such as `production`, and wire it into the relevant code path
+
+Typical prompts:
+
+```txt
+Create a prompt in Langfuse called "movie-critic" that takes a movie name and critic level as variables.
+```
+
+```txt
+Migrate the hardcoded prompts in this codebase to Langfuse.
+```
+
+```txt
+Fetch the "movie-critic" prompt, production version, from Langfuse and use it in my application.
+```
+
+## Why it works better than a generic coding prompt
+
+The skill gives the agent Langfuse-specific instructions for instrumentation, prompt migration, documentation lookup, and common workflows. That means the agent is not guessing how Langfuse should be used in your stack. It has explicit guidance on what to look for and which implementation patterns to prefer.
+
+## What you should expect
+
+In a good run, the output is a focused diff that wires Langfuse into the code you already have. You should still review the changes before merging. The agent can automate most of the setup, but the final result still depends on your environment variables, your application structure, and whether the agent can clearly infer the right integration points from the repo.