diff --git a/.cursor/skills/error-handling-patterns/SKILL.md b/.cursor/skills/error-handling-patterns/SKILL.md
index ba53143a..0f176c47 100644
--- a/.cursor/skills/error-handling-patterns/SKILL.md
+++ b/.cursor/skills/error-handling-patterns/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: error-handling-patterns
 description: Error handling patterns for GoodGo services. Use for custom error classes, exception handling, standardized error responses, or debugging.
-dependencies: "typescript>=5, zod>=3"
+compatibility: "typescript>=5, zod>=3"
 ---
 
 # Error Handling Patterns
diff --git a/.cursor/skills/microservices-development-process/SKILL.md b/.cursor/skills/microservices-development-process/SKILL.md
index 6d5cbdfa..cabbc952 100644
--- a/.cursor/skills/microservices-development-process/SKILL.md
+++ b/.cursor/skills/microservices-development-process/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: microservices-development-process
 description: Standard development process for GoodGo microservices. Use when creating, migrating, refactoring services, or planning implementations.
-dependencies: "node>=20, pnpm>=8, docker, kubernetes"
+compatibility: "node>=20, pnpm>=8, docker, kubernetes"
 ---
 
 # Microservices Development Process
@@ -734,6 +734,7 @@ modules/feature/
 
 ## Resources
 
+- [Detailed Reference](./references/REFERENCE.md) - Full code examples and implementation details
 - [Project Rules](../project-rules/SKILL.md) - Architecture and conventions
 - [API Design](../api-design/SKILL.md) - API design patterns
 - [Testing Patterns](../testing-patterns/SKILL.md) - Testing best practices
diff --git a/.cursor/skills/project-rules/SKILL.md b/.cursor/skills/project-rules/SKILL.md
index 3e1430db..861cc072 100644
--- a/.cursor/skills/project-rules/SKILL.md
+++ b/.cursor/skills/project-rules/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: project-rules
 description: GoodGo Platform coding standards and architecture. Use when working with services, apps, packages, or infrastructure.
-dependencies: "node>=20, typescript>=5, pnpm>=8"
+compatibility: "node>=20, typescript>=5, pnpm>=8"
 ---
 
 # GoodGo Project Rules
diff --git a/.cursor/skills/service-layer-patterns/SKILL.md b/.cursor/skills/service-layer-patterns/SKILL.md
index 89e1fc68..d0171ccd 100644
--- a/.cursor/skills/service-layer-patterns/SKILL.md
+++ b/.cursor/skills/service-layer-patterns/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: service-layer-patterns
 description: Service layer patterns for GoodGo microservices. Use for business logic, dependency injection, service composition, or controller-repository separation.
-dependencies: "typescript>=5"
+compatibility: "typescript>=5"
 ---
 
 # Service Layer Patterns