diff --git a/apps/docs/content/docs/reference/agent-skills.mdx b/apps/docs/content/docs/reference/agent-skills.mdx
index 7550910..9c8f71d 100644
--- a/apps/docs/content/docs/reference/agent-skills.mdx
+++ b/apps/docs/content/docs/reference/agent-skills.mdx
@@ -27,3 +27,13 @@ The skill covers:
- Debugging failing test cases
- Judge provider configuration
- Run comparison via `history --diff`
+
+## Agent harness integration
+
+Type `/regtrace init` inside an agent harness (OpenCode, Claude Code, Cursor,
+Zed, Aider, etc.) to bootstrap regtrace without writing config by hand. The
+agent scans your project for LLM signals — prompts, client calls, RAG chains,
+tools, and API routes — then generates golden sets and config wired to your
+actual code.
+
+See `skills/regtrace/SKILL.md` for the full workflow.
diff --git a/apps/docs/content/docs/tutorials/getting-started.mdx b/apps/docs/content/docs/tutorials/getting-started.mdx
index 640da84..0d34e20 100644
--- a/apps/docs/content/docs/tutorials/getting-started.mdx
+++ b/apps/docs/content/docs/tutorials/getting-started.mdx
@@ -57,6 +57,13 @@ This creates:
- `.env.example` — template with commented API key placeholders
- `.regtrace/runs/` — local run storage
+
+ **Using an AI coding agent?** Run `/regtrace init` in OpenCode, Claude Code,
+ Cursor, or Zed to auto-detect LLM calls in your project and generate
+ tailored golden sets — no manual editing needed. See the
+ [Agent Skill](/docs/reference/agent-skills) reference.
+
+
## Inspect the golden set
Open `golden-sets/qa.yaml`. It contains two test cases:
diff --git a/apps/docs/src/app/layout.tsx b/apps/docs/src/app/layout.tsx
index a8680d7..1b07c34 100644
--- a/apps/docs/src/app/layout.tsx
+++ b/apps/docs/src/app/layout.tsx
@@ -1,6 +1,7 @@
import { RootProvider } from "fumadocs-ui/provider/next";
import "./global.css";
import { Analytics } from "@vercel/analytics/next";
+import { Banner } from "fumadocs-ui/components/banner";
import type { Metadata } from "next";
import { Inter } from "next/font/google";
@@ -29,6 +30,9 @@ export default function Layout({ children }: LayoutProps<"/">) {
return (
+
+ Agent Skills are now supported for Regtrace!
+