diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
new file mode 100644
index 00000000..40592d6e
--- /dev/null
+++ b/.markdownlint-cli2.yaml
@@ -0,0 +1,2 @@
+ignores:
+  - "AGENTS.md"
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..e8be4782
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+<!-- intent-skills:start -->
+
+## Skill Loading
+
+Before editing files for a substantial task:
+
+- Run `npx @tanstack/intent@latest list` from the workspace root to see available local skills.
+- If a listed skill matches the task, run `npx @tanstack/intent@latest load <package>#<skill>` before changing files.
+- Use the loaded `SKILL.md` guidance while making the change.
+- Monorepos: when working across packages, run the skill check from the workspace root and prefer the local skill for the package being changed.
+- Multiple matches: prefer the most specific local skill for the package or concern you are changing; load additional skills only when the task spans multiple packages or concerns.
+
+<!-- intent-skills:end -->
\ No newline at end of file
diff --git a/package.json b/package.json
index 216a4fb6..7075f1f3 100644
--- a/package.json
+++ b/package.json
@@ -106,5 +106,10 @@
   "ct3aMetadata": {
     "initVersion": "7.23.1"
   },
+  "intent": {
+    "skills": [
+      "@tanstack/*"
+    ]
+  },
   "packageManager": "pnpm@12.4.2"
 }