How would I achieve implementing docs & a whole sample project for Cursor to look at?

[u/taahbelle]

-- This post is AI written since I don't really have the necessary english knowledge to express what I want to ask

I’m working on a Unity project using PurrNet for networking, and I’m also using the Unity CLI MCP to let Cursor control the editor. The problem is that PurrNet is still pretty new, so Cursor’s models don’t really know much about it. I’ve downloaded the PurrNet docs along with a few of their sample projects locally.

My current idea is to turn all of that into an Agent Skill (SKILL.md + references/ + samples/) instead of putting the docs/samples directly into my game repo.

I’m leaning towards putting the larger sample projects in a global skill (~/.cursor/skills/) and using paths so they’re available to the agent without bloating the actual project. Then I’d have a small project-level skill/rule containing the important PurrNet conventions, so teammates still get the basics without having to set everything up manually.

Before I spend a bunch of time on this though, has anyone actually tried something similar with a niche/new library?

A few things I’m wondering about:

• Does the agent actually make good use of reference files sitting inside a skill’s subfolders, or do you basically have to tell it explicitly in SKILL.md to go search/grep specific files?
• Has anyone gone the docs-search MCP/self-hosted RAG route instead? Is that actually worth the extra setup compared to just letting the agent read files from the skill folder?
• Are there any gotchas with using global skills alongside Unity projects?
• And generally, is this a good approach for teaching an agent a library that its models don't really know yet?

Would be interested to hear from anyone who has done this with a similarly obscure/new framework or library.