diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..66dcd0c
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# Agents
+
+Product docs for agents live in [microlinkhq/skills](https://github.com/microlinkhq/skills), not only in this repo's READMEs.
+
+When a change here would change how an agent calls Microlink, update the matching skill in the same effort (sibling checkout `../skills`, or a PR to that repo). Do not ship a removed or renamed API while the skill still documents the old one.
+
+| Change in | Update |
+| --- | --- |
+| `packages/core`, `packages/function`, `packages/search`, root `README.md` | `microlink/SKILL.md` |
+| `packages/mcp` | `microlink-mcp/SKILL.md` |
+| HTTP query params, embed URLs, extract/function grammar | `microlink-api/SKILL.md` and `microlink-api/api-reference.md` |
+
+That includes product methods, options, return types (including nullability), CLI commands/flags, MCP tools/config/errors, auth, and plan limits.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file