From e1e96f28f72068c1a7dce50bf127ace2a2f77620 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Wed, 4 Feb 2026 12:37:24 -0600
Subject: [PATCH] docs: link to "Working with AI" page on styling docs (#9602)

* docs: link to "Working with AI" page on styling docs

* don't truncate category descriptions in SKILLS.md
---
 packages/dev/s2-docs/pages/react-aria/getting-started.mdx | 2 +-
 packages/dev/s2-docs/pages/s2/styling.mdx                 | 3 +--
 packages/dev/s2-docs/scripts/generateAgentSkills.mjs      | 8 ++++----
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/packages/dev/s2-docs/pages/react-aria/getting-started.mdx b/packages/dev/s2-docs/pages/react-aria/getting-started.mdx
index e1751f9c3e4..13fc0ba8d30 100644
--- a/packages/dev/s2-docs/pages/react-aria/getting-started.mdx
+++ b/packages/dev/s2-docs/pages/react-aria/getting-started.mdx
@@ -75,7 +75,7 @@ If you're building a full component library, download a pre-built [Storybook](ht
 
 ### Working with AI
 
-Use the menu on each page in the docs to open or copy it into your favorite AI assistant. We also have an [MCP server](ai.html#mcp-server) which can be used directly in your IDE, [Agent Skills](ai.html#agent-skills) which can be installed in your project, and <Link href="llms.txt" target="_blank">llms.txt</Link> which can help AI agents navigate the docs.
+Use the menu on each page in the docs to open or copy it into your favorite AI assistant. We also have an [MCP server](ai#mcp-server) which can be used directly in your IDE, [Agent Skills](ai#agent-skills) which can be installed in your project, and <Link href="llms.txt" target="_blank">llms.txt</Link> which can help AI agents navigate the docs.
 
 ## Build a component from scratch
 
diff --git a/packages/dev/s2-docs/pages/s2/styling.mdx b/packages/dev/s2-docs/pages/s2/styling.mdx
index 864b2ee413f..f791f8fb97b 100644
--- a/packages/dev/s2-docs/pages/s2/styling.mdx
+++ b/packages/dev/s2-docs/pages/s2/styling.mdx
@@ -321,8 +321,7 @@ in a non-atomic format, making it easier to scan.
 - This [sandbox](https://codesandbox.io/p/devbox/react-spectrum-s2-style-macro-template-h6fpsq) is preconfigured to support React Spectrum S2, React Aria Components, and
 the `style` macros for quick prototyping.
 
-- If you are using Cursor, we offer a set of [Cursor rules](https://github.com/adobe/react-spectrum/blob/main/rules/style-macro.mdc) to use when developing with style macros. Additionally,
-we have MCP servers for [React Aria](ai.html#mcp-server) and [React Spectrum](ai.html#mcp-server) respectively that interface with the docs.
+- See [Working with AI](ai) to learn how to install the MCP server or Agent Skills for your AI coding tools.
 
 ## FAQ
 
diff --git a/packages/dev/s2-docs/scripts/generateAgentSkills.mjs b/packages/dev/s2-docs/scripts/generateAgentSkills.mjs
index 933faac8f49..e9e019140bf 100644
--- a/packages/dev/s2-docs/scripts/generateAgentSkills.mjs
+++ b/packages/dev/s2-docs/scripts/generateAgentSkills.mjs
@@ -328,7 +328,7 @@ The \`references/\` directory contains detailed documentation organized as follo
     content += `### Guides
 `;
     for (const entry of categories.guides) {
-      content += `- [${entry.title}](references/guides/${entry.path})${entry.description ? `: ${entry.description.slice(0, 100)}` : ''}\n`;
+      content += `- [${entry.title}](references/guides/${entry.path})${entry.description ? `: ${entry.description}` : ''}\n`;
     }
     content += '\n';
   }
@@ -337,7 +337,7 @@ The \`references/\` directory contains detailed documentation organized as follo
     content += `### Components
 `;
     for (const entry of categories.components) {
-      content += `- [${entry.title}](references/components/${entry.path})${entry.description ? `: ${entry.description.slice(0, 80)}` : ''}\n`;
+      content += `- [${entry.title}](references/components/${entry.path})${entry.description ? `: ${entry.description}` : ''}\n`;
     }
     content += '\n';
   }
@@ -346,7 +346,7 @@ The \`references/\` directory contains detailed documentation organized as follo
     content += `### Interactions
 `;
     for (const entry of categories.interactions) {
-      content += `- [${entry.title}](references/interactions/${entry.path})${entry.description ? `: ${entry.description.slice(0, 80)}` : ''}\n`;
+      content += `- [${entry.title}](references/interactions/${entry.path})${entry.description ? `: ${entry.description}` : ''}\n`;
     }
     content += '\n';
   }
@@ -355,7 +355,7 @@ The \`references/\` directory contains detailed documentation organized as follo
     content += `### Utilities
 `;
     for (const entry of categories.utilities) {
-      content += `- [${entry.title}](references/utilities/${entry.path})${entry.description ? `: ${entry.description.slice(0, 80)}` : ''}\n`;
+      content += `- [${entry.title}](references/utilities/${entry.path})${entry.description ? `: ${entry.description}` : ''}\n`;
     }
     content += '\n';
   }