chore: add Agent Skills

[reidbarber]

Related to #9508.

Adds a script to generate Agent Skills based on our documentation.

This yarn generate:skills script uses our existing markdown docs build output, and copies/formats them to match the Agent Skills spec. The script outputs these into our docs build in the .well-known/ directory.

Users will be able to install them by via npx skills:

npx skills add https://react-spectrum.adobe.com
npx skills add https://react-aria.adobe.com

More resources:

• Overview: https://agentskills.io/home
• Cursor integration: https://cursor.com/docs/context/skills
• Claude integration: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
• VSCode integration: https://code.visualstudio.com/docs/copilot/customization/agent-skills
• Vercel's Skill Directory: https://skills.sh/
• Discovery RFC: https://github.com/cloudflare/agent-skills-discovery-rfc
• Why do we need MCP if skills exist now?: https://www.mintlify.com/blog/why-do-we-need-mcp-if-skills-exist

✅ Pull Request Checklist:

• Included link to corresponding React Spectrum GitHub Issue.
• Added/updated unit tests and storybook for this change (for new code or code which already has tests).
• Filled out test instructions.
• Updated documentation (if it already exists for this component).
• Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

Try running these in any project:

React Spectrum (S2):

npx skills add https://d1pzu54gtk2aed.cloudfront.net/pr/68b03d07077abad5951b08b149002e035195568f/

React Aria:

npx skills add https://d5iwopk28bdhl.cloudfront.net/pr/9f6cb62b9c23fe0e5cb6cfe6d9c0268a6ddbbce4/

The skills should get placed in the current project.

🧢 Your Project:

[devongovett]

do we need to commit these or can we deploy them as part of the docs build?

[reidbarber]

@devongovett I think the other options are:

• Publish a custom CLI tool (run via npx) that pulls from docs CDN and places skills in the user's current directory
• Include a setup.sh script in the rules directory that that pulls from docs CDN

I guess the setup.sh solution requires the least maintenance, but requires some extra work on the user's end.

[reidbarber]

Discussed with the team, and it seems like we're leaning towards this solution:

1. We release an Artifact with the zipped markdown docs each release.
2. Have our skills include a script that downloads and unzips that (optionally, use the user's installed version?)

[reidbarber]

Just noticed that npx skills added support for well-known vercel-labs/skills#138

so we might be able to just deploy these to the CDN and have them be installed that way.

[rspbot]

Build successful! 🎉

• View the storybook
• View the S2 storybook
• View the S2 docs
• View the React Aria docs

[rspbot]

Build successful! 🎉

• View the storybook
• View the S2 storybook
• View the S2 docs
• View the React Aria docs

[rspbot]

Build successful! 🎉

• View the storybook
• View the S2 storybook
• View the S2 docs
• View the React Aria docs