@cubis/foundry 0.3.31 → 0.3.33

package/workflows/skills/skills_index.json

@@ -1,49 +1,81 @@
 [
   {
+    "id": "accessibility",
     "name": "accessibility",
-    "path": ".agent/skills/accessibility/SKILL.md",
+    "canonical_id": "accessibility",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/accessibility/SKILL.md",
     "description": "Ensure Flutter apps meet WCAG 2.1 AA standards with proper semantics, focus management, and screen reader support",
     "triggers": []
   },
   {
+    "id": "api-designer",
     "name": "api-designer",
-    "path": ".agent/skills/api-designer/SKILL.md",
+    "canonical_id": "api-designer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/api-designer/SKILL.md",
     "description": "Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.",
     "triggers": []
   },
   {
+    "id": "api-patterns",
     "name": "api-patterns",
-    "path": ".agent/skills/api-patterns/SKILL.md",
+    "canonical_id": "api-patterns",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/api-patterns/SKILL.md",
     "description": "API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.",
     "triggers": []
   },
   {
+    "id": "app-builder",
     "name": "app-builder",
-    "path": ".agent/skills/app-builder/SKILL.md",
+    "canonical_id": "app-builder",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/app-builder/SKILL.md",
     "description": "Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.",
     "triggers": []
   },
   {
+    "id": "architecture",
     "name": "architecture",
-    "path": ".agent/skills/architecture/SKILL.md",
-    "description": "Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.",
+    "canonical_id": "architecture-designer",
+    "deprecated": true,
+    "replaced_by": "architecture-designer",
+    "path": ".agents/skills/architecture/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use architecture-designer.",
     "triggers": []
   },
   {
+    "id": "architecture-designer",
     "name": "architecture-designer",
-    "path": ".agent/skills/architecture-designer/SKILL.md",
+    "canonical_id": "architecture-designer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/architecture-designer/SKILL.md",
     "description": "Use when designing new system architecture, reviewing existing designs, or making architectural decisions. Invoke for system design, architecture review, design patterns, ADRs, scalability planning.",
     "triggers": []
   },
   {
+    "id": "ask-questions-if-underspecified",
     "name": "ask-questions-if-underspecified",
-    "path": ".agent/skills/ask-questions-if-underspecified/SKILL.md",
+    "canonical_id": "ask-questions-if-underspecified",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/ask-questions-if-underspecified/SKILL.md",
     "description": "Clarify requirements before implementing. Use when serious doubts arise.",
     "triggers": []
   },
   {
+    "id": "atlassian-mcp",
     "name": "atlassian-mcp",
-    "path": ".agent/skills/atlassian-mcp/SKILL.md",
+    "canonical_id": "atlassian-mcp",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/atlassian-mcp/SKILL.md",
     "description": "Use when querying Jira issues, searching Confluence pages, creating tickets, updating documentation, or integrating Atlassian tools via MCP protocol.",
     "triggers": [
       "Jira",
@@ -61,68 +93,142 @@
     ]
   },
   {
+    "id": "bash-linux",
     "name": "bash-linux",
-    "path": ".agent/skills/bash-linux/SKILL.md",
+    "canonical_id": "bash-linux",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/bash-linux/SKILL.md",
     "description": "Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.",
     "triggers": []
   },
   {
+    "id": "behavioral-modes",
     "name": "behavioral-modes",
-    "path": ".agent/skills/behavioral-modes/SKILL.md",
+    "canonical_id": "behavioral-modes",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/behavioral-modes/SKILL.md",
     "description": "AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.",
     "triggers": []
   },
   {
+    "id": "brainstorming",
     "name": "brainstorming",
-    "path": ".agent/skills/brainstorming/SKILL.md",
+    "canonical_id": "brainstorming",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/brainstorming/SKILL.md",
     "description": "Socratic questioning protocol + user communication. MANDATORY for complex requests, new features, or unclear requirements. Includes progress reporting and error handling.",
     "triggers": []
   },
   {
+    "id": "building-mcp-server-on-cloudflare",
     "name": "building-mcp-server-on-cloudflare",
-    "path": ".agent/skills/building-mcp-server-on-cloudflare/SKILL.md",
+    "canonical_id": "building-mcp-server-on-cloudflare",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/building-mcp-server-on-cloudflare/SKILL.md",
     "description": "Build and deploy remote MCP servers on Cloudflare Workers with tools, OAuth authentication, and production configuration.",
     "triggers": []
   },
   {
+    "id": "changelog-generator",
     "name": "changelog-generator",
-    "path": ".agent/skills/changelog-generator/SKILL.md",
+    "canonical_id": "changelog-generator",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/changelog-generator/SKILL.md",
     "description": "Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.",
     "triggers": []
   },
   {
+    "id": "clean-code",
     "name": "clean-code",
-    "path": ".agent/skills/clean-code/SKILL.md",
+    "canonical_id": "clean-code",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/clean-code/SKILL.md",
     "description": "Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments",
     "triggers": []
   },
   {
+    "id": "cli-developer",
     "name": "cli-developer",
-    "path": ".agent/skills/cli-developer/SKILL.md",
+    "canonical_id": "cli-developer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/cli-developer/SKILL.md",
     "description": "Build intuitive, cross-platform CLI tools with argument parsing, interactive prompts, progress indicators, and shell completions across Node.js, Python, and Go",
     "triggers": []
   },
   {
+    "id": "code-documenter",
     "name": "code-documenter",
-    "path": ".agent/skills/code-documenter/SKILL.md",
+    "canonical_id": "code-documenter",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/code-documenter/SKILL.md",
     "description": "Use when adding docstrings, creating API documentation, or building documentation sites. Invoke for OpenAPI/Swagger specs, JSDoc, doc portals, tutorials, user guides.",
     "triggers": []
   },
   {
+    "id": "code-review-checklist",
     "name": "code-review-checklist",
-    "path": ".agent/skills/code-review-checklist/SKILL.md",
-    "description": "Code review guidelines covering code quality, security, and best practices.",
+    "canonical_id": "code-reviewer",
+    "deprecated": true,
+    "replaced_by": "code-reviewer",
+    "path": ".agents/skills/code-review-checklist/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use code-reviewer.",
     "triggers": []
   },
   {
+    "id": "code-reviewer",
     "name": "code-reviewer",
-    "path": ".agent/skills/code-reviewer/SKILL.md",
+    "canonical_id": "code-reviewer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/code-reviewer/SKILL.md",
     "description": "Use when reviewing pull requests, conducting code quality audits, or identifying security vulnerabilities. Invoke for PR reviews, code quality checks, refactoring suggestions.",
     "triggers": []
   },
   {
+    "id": "csharp-pro",
+    "name": "csharp-pro",
+    "canonical_id": "csharp-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/csharp-pro/SKILL.md",
+    "description": "Use for modern C# backend/application engineering with C# 14 and .NET 10-era production practices.",
+    "triggers": []
+  },
+  {
+    "id": "database-design",
+    "name": "database-design",
+    "canonical_id": "database-design",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/database-design/SKILL.md",
+    "description": "Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.",
+    "triggers": []
+  },
+  {
+    "id": "database-optimizer",
+    "name": "database-optimizer",
+    "canonical_id": "database-optimizer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/database-optimizer/SKILL.md",
+    "description": "Use for system-level database performance triage across engines: bottleneck analysis, indexing strategy, config tuning, partitioning, and lock contention.",
+    "triggers": []
+  },
+  {
+    "id": "database-skills",
     "name": "database-skills",
-    "path": ".agent/skills/database-skills/SKILL.md",
+    "canonical_id": "database-skills",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/database-skills/SKILL.md",
     "description": "Unified database skill hub with engine-specific packs for PostgreSQL, MySQL, Vitess, Neki, MongoDB (Mongoose), SQLite, Supabase, and Redis.",
     "triggers": [
       "database",
@@ -139,54 +245,102 @@
       "schema",
       "migration",
       "index",
-      "query"
+      "query",
+      "performance",
+      "pagination",
+      "replication",
+      "pooling",
+      "sharding",
+      "cache"
     ]
   },
   {
+    "id": "datadog-automation",
     "name": "datadog-automation",
-    "path": ".agent/skills/datadog-automation/SKILL.md",
+    "canonical_id": "datadog-automation",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/datadog-automation/SKILL.md",
     "description": "Automate Datadog tasks via Rube MCP (Composio): query metrics, search logs, manage monitors/dashboards, create events and downtimes. Always search tools first for current schemas.",
     "triggers": []
   },
   {
+    "id": "debugging-wizard",
     "name": "debugging-wizard",
-    "path": ".agent/skills/debugging-wizard/SKILL.md",
-    "description": "Use when investigating errors, analyzing stack traces, or finding root causes of unexpected behavior. Invoke for error investigation, troubleshooting, log analysis, root cause analysis.",
+    "canonical_id": "systematic-debugging",
+    "deprecated": true,
+    "replaced_by": "systematic-debugging",
+    "path": ".agents/skills/debugging-wizard/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use systematic-debugging.",
     "triggers": []
   },
   {
+    "id": "deployment-procedures",
     "name": "deployment-procedures",
-    "path": ".agent/skills/deployment-procedures/SKILL.md",
-    "description": "Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.",
+    "canonical_id": "devops-engineer",
+    "deprecated": true,
+    "replaced_by": "devops-engineer",
+    "path": ".agents/skills/deployment-procedures/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use devops-engineer.",
     "triggers": []
   },
   {
+    "id": "design-system-builder",
     "name": "design-system-builder",
-    "path": ".agent/skills/design-system-builder/SKILL.md",
+    "canonical_id": "design-system-builder",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/design-system-builder/SKILL.md",
     "description": "Create and review design system components: API design, token usage, theming, variants, and documentation",
     "triggers": []
   },
   {
+    "id": "devops-engineer",
     "name": "devops-engineer",
-    "path": ".agent/skills/devops-engineer/SKILL.md",
+    "canonical_id": "devops-engineer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/devops-engineer/SKILL.md",
     "description": "Use when setting up CI/CD pipelines, containerizing applications, or managing infrastructure as code. Invoke for pipelines, Docker, Kubernetes, cloud platforms, GitOps.",
     "triggers": []
   },
   {
+    "id": "documentation-templates",
     "name": "documentation-templates",
-    "path": ".agent/skills/documentation-templates/SKILL.md",
+    "canonical_id": "documentation-templates",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/documentation-templates/SKILL.md",
     "description": "Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.",
     "triggers": []
   },
   {
+    "id": "drift-flutter",
+    "name": "drift-flutter",
+    "canonical_id": "drift-flutter",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/drift-flutter/SKILL.md",
+    "description": "Use when implementing Flutter local persistence with Drift: schema design, DAOs, migrations, transactions, and repository integration",
+    "triggers": []
+  },
+  {
+    "id": "error-ux-observability",
     "name": "error-ux-observability",
-    "path": ".agent/skills/error-ux-observability/SKILL.md",
+    "canonical_id": "error-ux-observability",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/error-ux-observability/SKILL.md",
     "description": "Map backend failures to user-friendly messages, implement proper logging levels, and ensure observable error handling",
     "triggers": []
   },
   {
+    "id": "fastapi-expert",
     "name": "fastapi-expert",
-    "path": ".agent/skills/fastapi-expert/SKILL.md",
+    "canonical_id": "fastapi-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/fastapi-expert/SKILL.md",
     "description": "Use when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke for async SQLAlchemy, JWT authentication, WebSockets, OpenAPI documentation.",
     "triggers": [
       "FastAPI",
@@ -201,14 +355,22 @@
     ]
   },
   {
+    "id": "fastify-patterns",
     "name": "fastify-patterns",
-    "path": ".agent/skills/fastify-patterns/SKILL.md",
+    "canonical_id": "fastify-patterns",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/fastify-patterns/SKILL.md",
     "description": "NestJS + Fastify integration patterns including secure sessions, cookie authentication, performance optimization, and plugin configuration. Use for high-performance API development.",
     "triggers": []
   },
   {
+    "id": "feature-forge",
     "name": "feature-forge",
-    "path": ".agent/skills/feature-forge/SKILL.md",
+    "canonical_id": "feature-forge",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/feature-forge/SKILL.md",
     "description": "Use when defining new features, gathering requirements, or writing specifications. Invoke for feature definition, requirements gathering, user stories, EARS format specs.",
     "triggers": [
       "requirements",
@@ -220,96 +382,142 @@
     ]
   },
   {
+    "id": "find-bugs",
     "name": "find-bugs",
-    "path": ".agent/skills/find-bugs/SKILL.md",
+    "canonical_id": "find-bugs",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/find-bugs/SKILL.md",
     "description": "Find bugs, security vulnerabilities, and code quality issues in local branch changes. Use when asked to review changes, find bugs, security review, or audit code on the current branch.",
     "triggers": []
   },
   {
+    "id": "fix-review",
     "name": "fix-review",
-    "path": ".agent/skills/fix-review/SKILL.md",
+    "canonical_id": "fix-review",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/fix-review/SKILL.md",
     "description": "Verify remediation commits against security audit findings and confirm fixes without introducing regressions.",
     "triggers": []
   },
   {
+    "id": "flutter-code-reviewer",
     "name": "flutter-code-reviewer",
-    "path": ".agent/skills/flutter-code-reviewer/SKILL.md",
+    "canonical_id": "flutter-code-reviewer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/flutter-code-reviewer/SKILL.md",
     "description": "Perform strict, actionable code reviews for Flutter/Dart projects enforcing architecture boundaries, Riverpod patterns, testing, and performance",
     "triggers": []
   },
   {
+    "id": "flutter-expert",
     "name": "flutter-expert",
-    "path": ".agent/skills/flutter-expert/SKILL.md",
+    "canonical_id": "flutter-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/flutter-expert/SKILL.md",
     "description": "Flutter app architecture coordinator for Clean Architecture projects; delegates state, routing, persistence, testing, and security to specialized skills",
     "triggers": []
   },
   {
+    "id": "flutter-security-reviewer",
     "name": "flutter-security-reviewer",
-    "path": ".agent/skills/flutter-security-reviewer/SKILL.md",
+    "canonical_id": "flutter-security-reviewer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/flutter-security-reviewer/SKILL.md",
     "description": "Review Flutter/Dart code for security vulnerabilities: secure storage, network hardening, log redaction, and data protection",
     "triggers": []
   },
   {
+    "id": "flutter-test-master",
     "name": "flutter-test-master",
-    "path": ".agent/skills/flutter-test-master/SKILL.md",
+    "canonical_id": "flutter-test-master",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/flutter-test-master/SKILL.md",
     "description": "Comprehensive Flutter testing guide covering unit tests, widget tests, integration tests, golden tests, and Riverpod provider testing with mocktail",
     "triggers": []
   },
   {
+    "id": "frontend-design",
     "name": "frontend-design",
-    "path": ".agent/skills/frontend-design/SKILL.md",
+    "canonical_id": "frontend-design",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/frontend-design/SKILL.md",
     "description": "Design thinking and decision-making for web UI. Use when designing components, layouts, color schemes, typography, or creating aesthetic interfaces. Teaches principles, not fixed values.",
     "triggers": []
   },
   {
+    "id": "game-development",
     "name": "game-development",
-    "path": ".agent/skills/game-development/SKILL.md",
+    "canonical_id": "game-development",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/game-development/SKILL.md",
     "description": "Game development orchestrator. Routes to platform-specific skills based on project needs.",
     "triggers": []
   },
   {
+    "id": "geo-fundamentals",
     "name": "geo-fundamentals",
-    "path": ".agent/skills/geo-fundamentals/SKILL.md",
+    "canonical_id": "geo-fundamentals",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/geo-fundamentals/SKILL.md",
     "description": "Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).",
     "triggers": []
   },
   {
+    "id": "git-commit",
     "name": "git-commit",
-    "path": ".agent/skills/git-commit/SKILL.md",
+    "canonical_id": "git-commit",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/git-commit/SKILL.md",
     "description": "Create conventional commits with intelligent staging and message generation",
     "triggers": []
   },
   {
+    "id": "github-automation",
     "name": "github-automation",
-    "path": ".agent/skills/github-automation/SKILL.md",
+    "canonical_id": "github-automation",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/github-automation/SKILL.md",
     "description": "Automate GitHub repositories, issues, pull requests, branches, CI/CD, and permissions via Rube MCP (Composio). Manage code workflows, review PRs, search code, and handle deployments programmatically.",
     "triggers": []
   },
   {
+    "id": "golang-pro",
     "name": "golang-pro",
-    "path": ".agent/skills/golang-pro/SKILL.md",
-    "description": "Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration.",
-    "triggers": [
-      "Go",
-      "Golang",
-      "goroutines",
-      "channels",
-      "gRPC",
-      "microservices Go",
-      "Go generics",
-      "concurrent programming",
-      "Go interfaces"
-    ]
+    "canonical_id": "golang-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/golang-pro/SKILL.md",
+    "description": "Use for modern Go services and tooling with Go 1.26-era language/runtime patterns, concurrency safety, and production operations.",
+    "triggers": []
   },
   {
+    "id": "gorouter-restoration",
     "name": "gorouter-restoration",
-    "path": ".agent/skills/gorouter-restoration/SKILL.md",
+    "canonical_id": "gorouter-restoration",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/gorouter-restoration/SKILL.md",
     "description": "GoRouter guard patterns, deep links, redirect safety, tab preservation, and restoration best practices",
     "triggers": []
   },
   {
+    "id": "graphql-architect",
     "name": "graphql-architect",
-    "path": ".agent/skills/graphql-architect/SKILL.md",
+    "canonical_id": "graphql-architect",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/graphql-architect/SKILL.md",
     "description": "Use when designing GraphQL schemas, implementing Apollo Federation, or building real-time subscriptions. Invoke for schema design, resolvers with DataLoader, query optimization, federation directives.",
     "triggers": [
       "GraphQL",
@@ -324,36 +532,62 @@
     ]
   },
   {
+    "id": "i18n-localization",
     "name": "i18n-localization",
-    "path": ".agent/skills/i18n-localization/SKILL.md",
+    "canonical_id": "i18n-localization",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/i18n-localization/SKILL.md",
     "description": "Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.",
     "triggers": []
   },
   {
+    "id": "intelligent-routing",
     "name": "intelligent-routing",
-    "path": ".agent/skills/intelligent-routing/SKILL.md",
+    "canonical_id": "intelligent-routing",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/intelligent-routing/SKILL.md",
     "description": "Automatic agent selection and intelligent task routing. Analyzes user requests and automatically selects the best specialist agent(s) without requiring explicit user mentions.",
     "triggers": []
   },
   {
+    "id": "java-pro",
+    "name": "java-pro",
+    "canonical_id": "java-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/java-pro/SKILL.md",
+    "description": "Use for modern Java backend and platform engineering with Java 25-era language/runtime practices.",
+    "triggers": []
+  },
+  {
+    "id": "javascript-pro",
     "name": "javascript-pro",
-    "path": ".agent/skills/javascript-pro/SKILL.md",
-    "description": "Use when building JavaScript applications with modern ES2023+ features, async patterns, or Node.js development. Invoke for vanilla JavaScript, browser APIs, performance optimization, module systems.",
-    "triggers": [
-      "JavaScript",
-      "ES2023",
-      "async await",
-      "Node.js",
-      "vanilla JavaScript",
-      "Web Workers",
-      "Fetch API",
-      "browser API",
-      "module system"
-    ]
+    "canonical_id": "javascript-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/javascript-pro/SKILL.md",
+    "description": "Use for modern JavaScript architecture and implementation across browser, Node, and edge runtimes with ES2025+ practices.",
+    "triggers": []
+  },
+  {
+    "id": "kotlin-pro",
+    "name": "kotlin-pro",
+    "canonical_id": "kotlin-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/kotlin-pro/SKILL.md",
+    "description": "Use for modern Kotlin backend/mobile/shared code with Kotlin 2.3-era language tooling and production patterns.",
+    "triggers": []
   },
   {
+    "id": "legacy-modernizer",
     "name": "legacy-modernizer",
-    "path": ".agent/skills/legacy-modernizer/SKILL.md",
+    "canonical_id": "legacy-modernizer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/legacy-modernizer/SKILL.md",
     "description": "Use when modernizing legacy systems, implementing incremental migration strategies, or reducing technical debt. Invoke for strangler fig pattern, monolith decomposition, framework upgrades.",
     "triggers": [
       "legacy modernization",
@@ -367,20 +601,32 @@
     ]
   },
   {
+    "id": "lint-and-validate",
     "name": "lint-and-validate",
-    "path": ".agent/skills/lint-and-validate/SKILL.md",
+    "canonical_id": "lint-and-validate",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/lint-and-validate/SKILL.md",
     "description": "Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers: lint, format, check, validate, types, static analysis.",
     "triggers": []
   },
   {
+    "id": "mcp-builder",
     "name": "mcp-builder",
-    "path": ".agent/skills/mcp-builder/SKILL.md",
+    "canonical_id": "mcp-builder",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/mcp-builder/SKILL.md",
     "description": "MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.",
     "triggers": []
   },
   {
+    "id": "mcp-developer",
     "name": "mcp-developer",
-    "path": ".agent/skills/mcp-developer/SKILL.md",
+    "canonical_id": "mcp-developer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/mcp-developer/SKILL.md",
     "description": "Use for implementing, debugging, and maintaining MCP servers/clients with SDKs, protocol compliance, transports, schemas, and security hardening.",
     "triggers": [
       "MCP",
@@ -394,20 +640,32 @@
     ]
   },
   {
+    "id": "microservices-architect",
     "name": "microservices-architect",
-    "path": ".agent/skills/microservices-architect/SKILL.md",
+    "canonical_id": "microservices-architect",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/microservices-architect/SKILL.md",
     "description": "Use when designing distributed systems, decomposing monoliths, or implementing microservices patterns. Invoke for service boundaries, DDD, saga patterns, event sourcing, service mesh, distributed tracing.",
     "triggers": []
   },
   {
+    "id": "mobile-design",
     "name": "mobile-design",
-    "path": ".agent/skills/mobile-design/SKILL.md",
+    "canonical_id": "mobile-design",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/mobile-design/SKILL.md",
     "description": "Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps.",
     "triggers": []
   },
   {
+    "id": "monitoring-expert",
     "name": "monitoring-expert",
-    "path": ".agent/skills/monitoring-expert/SKILL.md",
+    "canonical_id": "monitoring-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/monitoring-expert/SKILL.md",
     "description": "Use when setting up monitoring systems, logging, metrics, tracing, or alerting. Invoke for dashboards, Prometheus/Grafana, load testing, profiling, capacity planning.",
     "triggers": [
       "monitoring",
@@ -428,74 +686,132 @@
     ]
   },
   {
+    "id": "nestjs-expert",
     "name": "nestjs-expert",
-    "path": ".agent/skills/nestjs-expert/SKILL.md",
+    "canonical_id": "nestjs-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/nestjs-expert/SKILL.md",
     "description": "Use when building NestJS applications requiring modular architecture, dependency injection, or TypeScript backend development. Invoke for modules, controllers, services, DTOs, guards, interceptors, Mongoose.",
     "triggers": []
   },
   {
+    "id": "next-best-practices",
     "name": "next-best-practices",
-    "path": ".agent/skills/next-best-practices/SKILL.md",
+    "canonical_id": "next-best-practices",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/next-best-practices/SKILL.md",
     "description": "Rulebook for reviewing/generating Next.js code against Vercel best practices (conventions, RSC boundaries, async APIs, metadata, bundling). Not a migration or feature-implementation skill by itself.",
     "triggers": []
   },
   {
+    "id": "next-cache-components",
     "name": "next-cache-components",
-    "path": ".agent/skills/next-cache-components/SKILL.md",
+    "canonical_id": "next-cache-components",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/next-cache-components/SKILL.md",
     "description": "Use only for Next.js 16 Cache Components and PPR implementation (use cache, cacheLife, cacheTag, updateTag, Suspense boundaries).",
     "triggers": []
   },
   {
+    "id": "next-upgrade",
     "name": "next-upgrade",
-    "path": ".agent/skills/next-upgrade/SKILL.md",
+    "canonical_id": "next-upgrade",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/next-upgrade/SKILL.md",
     "description": "Use only for upgrading Next.js versions with official migration guides and codemods; includes dependency/version planning and upgrade validation.",
     "triggers": []
   },
   {
+    "id": "nextjs-developer",
     "name": "nextjs-developer",
-    "path": ".agent/skills/nextjs-developer/SKILL.md",
-    "description": "Use for implementing/refactoring Next.js App Router features, Server Components/Actions, SEO, and production architecture. Not for version migration workflows or cache-components-only tuning.",
+    "canonical_id": "nextjs-developer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/nextjs-developer/SKILL.md",
+    "description": "Use for implementing/refactoring Next.js App Router features, React Server Components/Actions, SEO, and production architecture.",
     "triggers": []
   },
   {
+    "id": "nextjs-react-expert",
+    "name": "nextjs-react-expert",
+    "canonical_id": "react-best-practices",
+    "deprecated": true,
+    "replaced_by": "react-best-practices",
+    "path": ".agents/skills/nextjs-react-expert/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use react-best-practices.",
+    "triggers": []
+  },
+  {
+    "id": "nodejs-best-practices",
     "name": "nodejs-best-practices",
-    "path": ".agent/skills/nodejs-best-practices/SKILL.md",
-    "description": "Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.",
+    "canonical_id": "nodejs-best-practices",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/nodejs-best-practices/SKILL.md",
+    "description": "Decision framework for modern Node.js backend architecture, operations, and security using current LTS-era practices.",
     "triggers": []
   },
   {
+    "id": "oneup-design",
     "name": "oneup-design",
-    "path": ".agent/skills/oneup-design/SKILL.md",
+    "canonical_id": "oneup-design",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/oneup-design/SKILL.md",
     "description": "OneUp HR design system with One* components, colors, spacing, and typography tokens",
     "triggers": []
   },
   {
+    "id": "openapi-docs",
     "name": "openapi-docs",
-    "path": ".agent/skills/openapi-docs/SKILL.md",
+    "canonical_id": "openapi-docs",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/openapi-docs/SKILL.md",
     "description": "Use when writing or updating OpenAPI specifications, defining request/response schemas, or configuring Stoplight Elements (Swagger-style) documentation UI.",
     "triggers": []
   },
   {
+    "id": "parallel-agents",
     "name": "parallel-agents",
-    "path": ".agent/skills/parallel-agents/SKILL.md",
+    "canonical_id": "parallel-agents",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/parallel-agents/SKILL.md",
     "description": "Multi-agent orchestration patterns. Use when multiple independent tasks can run with different domain expertise or when comprehensive analysis requires multiple perspectives.",
     "triggers": []
   },
   {
+    "id": "performance-profiling",
     "name": "performance-profiling",
-    "path": ".agent/skills/performance-profiling/SKILL.md",
+    "canonical_id": "performance-profiling",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/performance-profiling/SKILL.md",
     "description": "Performance profiling principles. Measurement, analysis, and optimization techniques.",
     "triggers": []
   },
   {
+    "id": "plan-writing",
     "name": "plan-writing",
-    "path": ".agent/skills/plan-writing/SKILL.md",
+    "canonical_id": "plan-writing",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/plan-writing/SKILL.md",
     "description": "Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.",
     "triggers": []
   },
   {
+    "id": "playwright-expert",
     "name": "playwright-expert",
-    "path": ".agent/skills/playwright-expert/SKILL.md",
+    "canonical_id": "playwright-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/playwright-expert/SKILL.md",
     "description": "Use when writing E2E tests with Playwright, setting up test infrastructure, or debugging flaky browser tests. Invoke for browser automation, E2E tests, Page Object Model, test flakiness, visual testing.",
     "triggers": [
       "Playwright",
@@ -508,133 +824,152 @@
     ]
   },
   {
+    "id": "postman",
     "name": "postman",
-    "path": ".agent/skills/postman/SKILL.md",
+    "canonical_id": "postman",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/postman/SKILL.md",
     "description": "Automate API testing and collection management with Postman - create workspaces, collections, environments, and run tests programmatically",
     "triggers": []
   },
   {
+    "id": "powershell-windows",
     "name": "powershell-windows",
-    "path": ".agent/skills/powershell-windows/SKILL.md",
+    "canonical_id": "powershell-windows",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/powershell-windows/SKILL.md",
     "description": "PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling.",
     "triggers": []
   },
   {
+    "id": "prompt-engineer",
     "name": "prompt-engineer",
-    "path": ".agent/skills/prompt-engineer/SKILL.md",
+    "canonical_id": "prompt-engineer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/prompt-engineer/SKILL.md",
     "description": "Design and optimize LLM prompts with chain-of-thought, few-shot learning, and evaluation frameworks",
     "triggers": []
   },
   {
+    "id": "python-patterns",
     "name": "python-patterns",
-    "path": ".agent/skills/python-patterns/SKILL.md",
-    "description": "Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.",
+    "canonical_id": "python-pro",
+    "deprecated": true,
+    "replaced_by": "python-pro",
+    "path": ".agents/skills/python-patterns/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use python-pro.",
     "triggers": []
   },
   {
+    "id": "python-pro",
     "name": "python-pro",
-    "path": ".agent/skills/python-pro/SKILL.md",
-    "description": "Use when building Python 3.11+ applications requiring type safety, async programming, or production-grade patterns. Invoke for type hints, pytest, async/await, dataclasses, mypy configuration.",
-    "triggers": [
-      "Python development",
-      "type hints",
-      "async Python",
-      "pytest",
-      "mypy",
-      "dataclasses",
-      "Python best practices",
-      "Pythonic code"
-    ]
-  },
-  {
-    "name": "react-best-practices",
-    "path": ".agent/skills/nextjs-react-expert/SKILL.md",
-    "description": "React and Next.js performance optimization from Vercel Engineering. Use when building React components, optimizing performance, eliminating waterfalls, reducing bundle size, reviewing code for performance issues, or implementing server/client-side optimizations.",
+    "canonical_id": "python-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/python-pro/SKILL.md",
+    "description": "Use for production Python with 3.14-era typing, async, packaging, and testing standards.",
     "triggers": []
   },
   {
+    "id": "react-best-practices",
     "name": "react-best-practices",
-    "path": ".agent/skills/react-best-practices/SKILL.md",
-    "description": "Performance-focused React/Next.js review checklist from Vercel. Use for optimization/refactor passes, not as the primary implementation skill.",
+    "canonical_id": "react-best-practices",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/react-best-practices/SKILL.md",
+    "description": "Performance-focused React/Next.js review checklist. Use for audits and optimization passes, not as primary implementation skill.",
     "triggers": []
   },
   {
+    "id": "react-expert",
     "name": "react-expert",
-    "path": ".agent/skills/react-expert/SKILL.md",
-    "description": "Use for framework-agnostic React component architecture, hooks/state patterns, and React 19 APIs. For Next.js routing/App Router specifics, use nextjs-developer.",
-    "triggers": [
-      "React",
-      "JSX",
-      "hooks",
-      "useState",
-      "useEffect",
-      "useContext",
-      "Server Components",
-      "React 19",
-      "Suspense",
-      "TanStack Query",
-      "Redux",
-      "Zustand",
-      "component",
-      "frontend"
-    ]
+    "canonical_id": "react-expert",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/react-expert/SKILL.md",
+    "description": "Use for framework-agnostic React architecture with React 19 patterns, state design, and performance tuning.",
+    "triggers": []
   },
   {
+    "id": "red-team-tactics",
     "name": "red-team-tactics",
-    "path": ".agent/skills/red-team-tactics/SKILL.md",
+    "canonical_id": "red-team-tactics",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/red-team-tactics/SKILL.md",
     "description": "Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting.",
     "triggers": []
   },
   {
+    "id": "refactor",
     "name": "refactor",
-    "path": ".agent/skills/refactor/SKILL.md",
+    "canonical_id": "refactor",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/refactor/SKILL.md",
     "description": "Migrate legacy code to new architecture while maintaining behavior",
     "triggers": []
   },
   {
+    "id": "riverpod-3",
     "name": "riverpod-3",
-    "path": ".agent/skills/riverpod-3/SKILL.md",
+    "canonical_id": "riverpod-3",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/riverpod-3/SKILL.md",
     "description": "Riverpod 3 best practices for codegen, UI interaction boundaries, caching, paging, lifecycle, and testing",
     "triggers": []
   },
   {
+    "id": "rust-engineer",
     "name": "rust-engineer",
-    "path": ".agent/skills/rust-engineer/SKILL.md",
-    "description": "Use when building Rust applications requiring memory safety, systems programming, or zero-cost abstractions. Invoke for ownership patterns, lifetimes, traits, async/await with tokio.",
-    "triggers": [
-      "Rust",
-      "Cargo",
-      "ownership",
-      "borrowing",
-      "lifetimes",
-      "async Rust",
-      "tokio",
-      "zero-cost abstractions",
-      "memory safety",
-      "systems programming"
-    ]
+    "canonical_id": "rust-pro",
+    "deprecated": true,
+    "replaced_by": "rust-pro",
+    "path": ".agents/skills/rust-engineer/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use rust-pro.",
+    "triggers": []
   },
   {
+    "id": "rust-pro",
     "name": "rust-pro",
-    "path": ".agent/skills/rust-pro/SKILL.md",
-    "description": "Master Rust 1.75+ with modern async patterns, advanced type system",
+    "canonical_id": "rust-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/rust-pro/SKILL.md",
+    "description": "Use for modern Rust systems/services with stable 1.91-era patterns, async correctness, and performance-focused design.",
     "triggers": []
   },
   {
+    "id": "saas-builder",
     "name": "saas-builder",
-    "path": ".agent/skills/saas-builder/SKILL.md",
+    "canonical_id": "saas-builder",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/saas-builder/SKILL.md",
     "description": "Build or review production-ready multi-tenant SaaS systems on AWS serverless architecture with React + TypeScript frontend, tenant-isolated DynamoDB data models, JWT/RBAC authorization, Stripe subscriptions, and usage-based billing. Use for SaaS architecture design, implementation planning, API/Lambda patterns, billing workflows, and tenant isolation audits.",
     "triggers": []
   },
   {
+    "id": "sarif-parsing",
     "name": "sarif-parsing",
-    "path": ".agent/skills/sarif-parsing/SKILL.md",
+    "canonical_id": "sarif-parsing",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/sarif-parsing/SKILL.md",
     "description": "Parse, analyze, and process SARIF (Static Analysis Results Interchange Format) files. Use when reading security scan results, aggregating findings from multiple tools, deduplicating alerts, extracting specific vulnerabilities, or integrating SARIF data into CI/CD pipelines.",
     "triggers": []
   },
   {
+    "id": "secure-code-guardian",
     "name": "secure-code-guardian",
-    "path": ".agent/skills/secure-code-guardian/SKILL.md",
+    "canonical_id": "secure-code-guardian",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/secure-code-guardian/SKILL.md",
     "description": "Use when implementing authentication/authorization, securing user input, or preventing OWASP Top 10 vulnerabilities. Invoke for authentication, authorization, input validation, encryption, OWASP Top 10 prevention.",
     "triggers": [
       "security",
@@ -650,38 +985,62 @@
     ]
   },
   {
+    "id": "security-reviewer",
     "name": "security-reviewer",
-    "path": ".agent/skills/security-reviewer/SKILL.md",
+    "canonical_id": "security-reviewer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/security-reviewer/SKILL.md",
     "description": "Use when conducting security audits, reviewing code for vulnerabilities, or analyzing infrastructure security. Invoke for SAST scans, penetration testing, DevSecOps practices, cloud security reviews.",
     "triggers": []
   },
   {
+    "id": "semgrep",
     "name": "semgrep",
-    "path": ".agent/skills/semgrep/SKILL.md",
+    "canonical_id": "semgrep",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/semgrep/SKILL.md",
     "description": "Run Semgrep static analysis scan on a codebase using parallel subagents. Automatically",
     "triggers": []
   },
   {
+    "id": "sentry-automation",
     "name": "sentry-automation",
-    "path": ".agent/skills/sentry-automation/SKILL.md",
+    "canonical_id": "sentry-automation",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/sentry-automation/SKILL.md",
     "description": "Automate Sentry tasks via Rube MCP (Composio): manage issues/events, configure alerts, track releases, monitor projects and teams. Always search tools first for current schemas.",
     "triggers": []
   },
   {
+    "id": "seo-fundamentals",
     "name": "seo-fundamentals",
-    "path": ".agent/skills/seo-fundamentals/SKILL.md",
+    "canonical_id": "seo-fundamentals",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/seo-fundamentals/SKILL.md",
     "description": "SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles.",
     "triggers": []
   },
   {
+    "id": "server-management",
     "name": "server-management",
-    "path": ".agent/skills/server-management/SKILL.md",
-    "description": "Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands.",
+    "canonical_id": "sre-engineer",
+    "deprecated": true,
+    "replaced_by": "sre-engineer",
+    "path": ".agents/skills/server-management/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use sre-engineer.",
     "triggers": []
   },
   {
+    "id": "spec-miner",
     "name": "spec-miner",
-    "path": ".agent/skills/spec-miner/SKILL.md",
+    "canonical_id": "spec-miner",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/spec-miner/SKILL.md",
     "description": "Use when understanding legacy or undocumented systems, creating documentation for existing code, or extracting specifications from implementations. Invoke for legacy analysis, code archaeology, undocumented features.",
     "triggers": [
       "reverse engineer",
@@ -693,8 +1052,12 @@
     ]
   },
   {
+    "id": "sre-engineer",
     "name": "sre-engineer",
-    "path": ".agent/skills/sre-engineer/SKILL.md",
+    "canonical_id": "sre-engineer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/sre-engineer/SKILL.md",
     "description": "Use when defining SLIs/SLOs, managing error budgets, or building reliable systems at scale. Invoke for incident management, chaos engineering, toil reduction, capacity planning.",
     "triggers": [
       "SRE",
@@ -710,44 +1073,72 @@
     ]
   },
   {
+    "id": "static-analysis",
     "name": "static-analysis",
-    "path": ".agent/skills/static-analysis/SKILL.md",
+    "canonical_id": "static-analysis",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/static-analysis/SKILL.md",
     "description": "Runs CodeQL-based static security analysis (database build, query pack selection, and SARIF results) for vulnerability discovery and audits. Not for custom QL authoring or CI/CD setup.",
     "triggers": []
   },
   {
+    "id": "stripe-best-practices",
     "name": "stripe-best-practices",
-    "path": ".agent/skills/stripe-best-practices/SKILL.md",
+    "canonical_id": "stripe-best-practices",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/stripe-best-practices/SKILL.md",
     "description": "Best practices for building Stripe integrations",
     "triggers": []
   },
   {
+    "id": "sub-agents",
     "name": "sub-agents",
-    "path": ".agent/skills/sub-agents/SKILL.md",
+    "canonical_id": "sub-agents",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/sub-agents/SKILL.md",
     "description": "Execute external CLI AIs as isolated sub-agents for task delegation, parallel processing, and context separation. Use when delegating complex multi-step tasks, running parallel investigations, needing fresh context without current conversation history, or leveraging specialized agent definitions. Returns structured JSON with agent output, exit code, and execution status.",
     "triggers": []
   },
   {
+    "id": "systematic-debugging",
     "name": "systematic-debugging",
-    "path": ".agent/skills/systematic-debugging/SKILL.md",
+    "canonical_id": "systematic-debugging",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/systematic-debugging/SKILL.md",
     "description": "4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.",
     "triggers": []
   },
   {
+    "id": "tailwind-patterns",
     "name": "tailwind-patterns",
-    "path": ".agent/skills/tailwind-patterns/SKILL.md",
+    "canonical_id": "tailwind-patterns",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/tailwind-patterns/SKILL.md",
     "description": "Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture.",
     "triggers": []
   },
   {
+    "id": "tdd-workflow",
     "name": "tdd-workflow",
-    "path": ".agent/skills/tdd-workflow/SKILL.md",
-    "description": "Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.",
+    "canonical_id": "test-master",
+    "deprecated": true,
+    "replaced_by": "test-master",
+    "path": ".agents/skills/tdd-workflow/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use test-master.",
     "triggers": []
   },
   {
+    "id": "terraform-engineer",
     "name": "terraform-engineer",
-    "path": ".agent/skills/terraform-engineer/SKILL.md",
+    "canonical_id": "terraform-engineer",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/terraform-engineer/SKILL.md",
     "description": "Use when implementing infrastructure as code with Terraform across AWS, Azure, or GCP. Invoke for module development, state management, provider configuration, multi-environment workflows, infrastructure testing.",
     "triggers": [
       "Terraform",
@@ -763,195 +1154,183 @@
     ]
   },
   {
+    "id": "test-master",
     "name": "test-master",
-    "path": ".agent/skills/test-master/SKILL.md",
+    "canonical_id": "test-master",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/test-master/SKILL.md",
     "description": "Use when writing tests, creating test strategies, or building automation frameworks. Invoke for unit tests, integration tests, E2E, coverage analysis, performance testing, security testing.",
     "triggers": []
   },
   {
+    "id": "testing-patterns",
     "name": "testing-patterns",
-    "path": ".agent/skills/testing-patterns/SKILL.md",
-    "description": "Testing patterns and principles. Unit, integration, mocking strategies.",
+    "canonical_id": "test-master",
+    "deprecated": true,
+    "replaced_by": "test-master",
+    "path": ".agents/skills/testing-patterns/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use test-master.",
     "triggers": []
   },
   {
+    "id": "typescript-pro",
     "name": "typescript-pro",
-    "path": ".agent/skills/typescript-pro/SKILL.md",
-    "description": "Use when building TypeScript applications requiring advanced type systems, generics, or full-stack type safety. Invoke for type guards, utility types, tRPC integration, monorepo setup.",
+    "canonical_id": "typescript-pro",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/typescript-pro/SKILL.md",
+    "description": "Use for TypeScript architecture and implementation with TS 5.9+ production baselines and TS 6/7 transition readiness.",
     "triggers": []
   },
   {
+    "id": "ui-ux-pro-max",
     "name": "ui-ux-pro-max",
-    "path": ".agent/skills/ui-ux-pro-max/SKILL.md",
+    "canonical_id": "ui-ux-pro-max",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/ui-ux-pro-max/SKILL.md",
     "description": "UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.",
     "triggers": []
   },
   {
+    "id": "ux-ui-consistency",
     "name": "ux-ui-consistency",
-    "path": ".agent/skills/ux-ui-consistency/SKILL.md",
+    "canonical_id": "ux-ui-consistency",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/ux-ui-consistency/SKILL.md",
     "description": "Ensure consistent UX patterns: design system component usage, screen states, error handling, and loading patterns",
     "triggers": []
   },
   {
+    "id": "variant-analysis",
     "name": "variant-analysis",
-    "path": ".agent/skills/variant-analysis/SKILL.md",
+    "canonical_id": "variant-analysis",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/variant-analysis/SKILL.md",
     "description": "Find similar vulnerabilities and bugs across codebases using pattern-based analysis. Use when hunting bug variants, building CodeQL/Semgrep queries, analyzing security vulnerabilities, or performing systematic code audits after finding an initial issue.",
     "triggers": []
   },
   {
+    "id": "vercel-ai",
+    "name": "vercel-ai",
+    "canonical_id": "null",
+    "deprecated": false,
+    "replaced_by": "null",
+    "path": ".agents/skills/vercel-ai/SKILL.md",
+    "description": "Canonical Vercel AI skill covering AI Gateway and AI SDK integration, routing, resilience, and observability.",
+    "triggers": []
+  },
+  {
+    "id": "vercel-ai-gateway",
     "name": "vercel-ai-gateway",
-    "path": ".agent/skills/vercel-ai-gateway/SKILL.md",
-    "description": "Complete Vercel AI Gateway integration: LLM traffic routing, authentication/BYOK, fallback chains, model-provider routing policies, usage observability, and OpenAI-compatible endpoints.",
-    "triggers": [
-      "vercel",
-      "ai gateway",
-      "llm",
-      "byok",
-      "fallback",
-      "model routing",
-      "openai compatible",
-      "token usage",
-      "ai observability"
-    ]
+    "canonical_id": "vercel-ai",
+    "deprecated": true,
+    "replaced_by": "vercel-ai",
+    "path": ".agents/skills/vercel-ai-gateway/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-ai.",
+    "triggers": []
   },
   {
+    "id": "vercel-ai-sdk",
     "name": "vercel-ai-sdk",
-    "path": ".agent/skills/vercel-ai-sdk/SKILL.md",
-    "description": "Vercel AI SDK for building AI-powered applications: core providers/streaming patterns and React/Svelte UI hooks for chat, completion, and generative UX.",
-    "triggers": [
-      "vercel",
-      "ai sdk",
-      "useChat",
-      "useCompletion",
-      "streamText",
-      "generateText",
-      "streaming",
-      "generative ui"
-    ]
+    "canonical_id": "vercel-ai",
+    "deprecated": true,
+    "replaced_by": "vercel-ai",
+    "path": ".agents/skills/vercel-ai-sdk/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-ai.",
+    "triggers": []
   },
   {
+    "id": "vercel-caching",
     "name": "vercel-caching",
-    "path": ".agent/skills/vercel-caching/SKILL.md",
-    "description": "Vercel caching strategies: CDN cache, cache-control headers, runtime cache, ISR, Next.js Data Cache, request collapsing, remote caching, and CDN purging.",
-    "triggers": [
-      "vercel",
-      "cdn cache",
-      "caching",
-      "isr",
-      "incremental static regeneration",
-      "data cache",
-      "request collapsing",
-      "remote caching",
-      "turborepo cache",
-      "cache purge",
-      "cache-control"
-    ]
+    "canonical_id": "vercel-runtime",
+    "deprecated": true,
+    "replaced_by": "vercel-runtime",
+    "path": ".agents/skills/vercel-caching/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-runtime.",
+    "triggers": []
   },
   {
+    "id": "vercel-cli",
     "name": "vercel-cli",
-    "path": ".agent/skills/vercel-cli/SKILL.md",
-    "description": "Vercel CLI mastery: core commands, flags, MCP integration, microfrontend management, and project/domain/environment variable operations.",
-    "triggers": [
-      "vercel cli",
-      "vercel command",
-      "npx vercel",
-      "vercel dev",
-      "vercel deploy",
-      "vercel env",
-      "vercel pull",
-      "vercel link",
-      "vercel mcp"
-    ]
+    "canonical_id": "vercel-delivery",
+    "deprecated": true,
+    "replaced_by": "vercel-delivery",
+    "path": ".agents/skills/vercel-cli/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-delivery.",
+    "triggers": []
   },
   {
+    "id": "vercel-delivery",
+    "name": "vercel-delivery",
+    "canonical_id": "null",
+    "deprecated": false,
+    "replaced_by": "null",
+    "path": ".agents/skills/vercel-delivery/SKILL.md",
+    "description": "Canonical Vercel delivery skill covering deployments, domains, flags, and CLI-driven release operations.",
+    "triggers": []
+  },
+  {
+    "id": "vercel-deployments",
     "name": "vercel-deployments",
-    "path": ".agent/skills/vercel-deployments/SKILL.md",
-    "description": "Vercel deployment lifecycle: git deployments, build pipeline, build output API, deployment promotion, environment management, preview/production protection, and generated URL patterns.",
-    "triggers": [
-      "vercel",
-      "deployment",
-      "git deploy",
-      "build pipeline",
-      "build output api",
-      "deployment promotion",
-      "environments",
-      "preview",
-      "production",
-      "protection",
-      "generated urls"
-    ]
+    "canonical_id": "vercel-delivery",
+    "deprecated": true,
+    "replaced_by": "vercel-delivery",
+    "path": ".agents/skills/vercel-deployments/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-delivery.",
+    "triggers": []
   },
   {
+    "id": "vercel-domains",
     "name": "vercel-domains",
-    "path": ".agent/skills/vercel-domains/SKILL.md",
-    "description": "Vercel domain management: custom domains, DNS records, nameservers, SSL certificates, domain ownership verification, and static IP configuration.",
-    "triggers": [
-      "vercel",
-      "domain",
-      "dns",
-      "nameservers",
-      "ssl",
-      "certificate",
-      "custom domain",
-      "cname",
-      "static ip",
-      "domain ownership"
-    ]
+    "canonical_id": "vercel-delivery",
+    "deprecated": true,
+    "replaced_by": "vercel-delivery",
+    "path": ".agents/skills/vercel-domains/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-delivery.",
+    "triggers": []
   },
   {
+    "id": "vercel-firewall",
     "name": "vercel-firewall",
-    "path": ".agent/skills/vercel-firewall/SKILL.md",
-    "description": "Vercel security controls: WAF core, custom firewall rules, rate limiting, bot management, and BotID fingerprinting for DDoS protection and traffic filtering.",
-    "triggers": [
-      "vercel",
-      "firewall",
-      "waf",
-      "rate limiting",
-      "bot protection",
-      "botid",
-      "ddos",
-      "abuse",
-      "traffic filtering",
-      "custom rules"
-    ]
+    "canonical_id": "vercel-security",
+    "deprecated": true,
+    "replaced_by": "vercel-security",
+    "path": ".agents/skills/vercel-firewall/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-security.",
+    "triggers": []
   },
   {
+    "id": "vercel-flags",
     "name": "vercel-flags",
-    "path": ".agent/skills/vercel-flags/SKILL.md",
-    "description": "Vercel Feature Flags: SDK integration, platform setup, CLI workflows, dashboard management, explorer UI, and OpenFeature compatibility for safe targeted rollouts.",
-    "triggers": [
-      "vercel",
-      "feature flags",
-      "flags sdk",
-      "flags platform",
-      "openfeature",
-      "flags dashboard",
-      "feature toggle",
-      "rollout",
-      "a/b test"
-    ]
+    "canonical_id": "vercel-delivery",
+    "deprecated": true,
+    "replaced_by": "vercel-delivery",
+    "path": ".agents/skills/vercel-flags/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-delivery.",
+    "triggers": []
   },
   {
+    "id": "vercel-functions",
     "name": "vercel-functions",
-    "path": ".agent/skills/vercel-functions/SKILL.md",
-    "description": "Vercel Serverless and Edge Functions: core patterns, Node.js and Python runtimes, edge runtime, Fluid Compute for long-running tasks, and function configuration.",
-    "triggers": [
-      "vercel",
-      "serverless",
-      "functions",
-      "edge function",
-      "nodejs runtime",
-      "python runtime",
-      "fluid compute",
-      "function config",
-      "api route",
-      "edge runtime"
-    ]
+    "canonical_id": "vercel-runtime",
+    "deprecated": true,
+    "replaced_by": "vercel-runtime",
+    "path": ".agents/skills/vercel-functions/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-runtime.",
+    "triggers": []
   },
   {
+    "id": "vercel-observability",
     "name": "vercel-observability",
-    "path": ".agent/skills/vercel-observability/SKILL.md",
-    "description": "Vercel observability stack: logs, tracing (OTel), session tracing, speed insights, web analytics, alerts, custom events, log drains, and audit logs.",
+    "canonical_id": "vercel-observability",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/vercel-observability/SKILL.md",
+    "description": "Vercel observability stack: logs, tracing (OTel), session tracing, speed insights, web analytics, alerts, custom events, log drains, audit logs, and structured monitoring.",
     "triggers": [
       "vercel",
       "observability",
@@ -969,9 +1348,13 @@
     ]
   },
   {
+    "id": "vercel-platform",
     "name": "vercel-platform",
-    "path": ".agent/skills/vercel-platform/SKILL.md",
-    "description": "Vercel platform operations: project config, RBAC, 2FA/OIDC/SSO, secure compute, REST API, SDK, webhooks, integrations, MCP for agents, image optimization, OG images, cron jobs, monorepos, microfrontends, and multi-tenant architecture.",
+    "canonical_id": "vercel-platform",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/vercel-platform/SKILL.md",
+    "description": "Vercel platform operations: project configuration, RBAC, 2FA/OIDC/SSO, secure compute, REST API, SDK, webhooks, integrations, MCP for agents, image optimization, OG images, cron jobs, monorepos, microfrontends, and multi-tenant architecture.",
     "triggers": [
       "vercel",
       "project config",
@@ -981,8 +1364,9 @@
       "sso",
       "secure compute",
       "rest api",
+      "vercel sdk",
       "webhooks",
-      "integrations",
+      "integrations marketplace",
       "mcp for agents",
       "image optimization",
       "og image",
@@ -990,28 +1374,47 @@
       "monorepo",
       "microfrontends",
       "multi-tenant",
-      "automation"
+      "automation",
+      "audit"
     ]
   },
   {
+    "id": "vercel-routing",
     "name": "vercel-routing",
-    "path": ".agent/skills/vercel-routing/SKILL.md",
-    "description": "Vercel edge routing: middleware patterns, redirects/rewrites, Edge Config for real-time config without redeploys, Edge Config integrations, and Node.js migration paths.",
-    "triggers": [
-      "vercel",
-      "routing",
-      "middleware",
-      "redirects",
-      "rewrites",
-      "edge config",
-      "a/b routing",
-      "geo routing",
-      "edge middleware"
-    ]
+    "canonical_id": "vercel-runtime",
+    "deprecated": true,
+    "replaced_by": "vercel-runtime",
+    "path": ".agents/skills/vercel-routing/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use vercel-runtime.",
+    "triggers": []
   },
   {
+    "id": "vercel-runtime",
+    "name": "vercel-runtime",
+    "canonical_id": "null",
+    "deprecated": false,
+    "replaced_by": "null",
+    "path": ".agents/skills/vercel-runtime/SKILL.md",
+    "description": "Canonical Vercel runtime skill covering functions, routing, and caching with production guardrails.",
+    "triggers": []
+  },
+  {
+    "id": "vercel-security",
+    "name": "vercel-security",
+    "canonical_id": "null",
+    "deprecated": false,
+    "replaced_by": "null",
+    "path": ".agents/skills/vercel-security/SKILL.md",
+    "description": "Canonical Vercel security skill covering WAF, rate limiting, bot controls, and traffic-protection policy.",
+    "triggers": []
+  },
+  {
+    "id": "vercel-storage",
     "name": "vercel-storage",
-    "path": ".agent/skills/vercel-storage/SKILL.md",
+    "canonical_id": "vercel-storage",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/vercel-storage/SKILL.md",
     "description": "Vercel Storage solutions: Blob for file storage, Marketplace Postgres, Marketplace Redis, and storage migration strategies between providers.",
     "triggers": [
       "vercel",
@@ -1028,51 +1431,53 @@
     ]
   },
   {
+    "id": "vulnerability-scanner",
     "name": "vulnerability-scanner",
-    "path": ".agent/skills/vulnerability-scanner/SKILL.md",
-    "description": "Advanced vulnerability analysis principles. OWASP 2025, Supply Chain Security, attack surface mapping, risk prioritization.",
+    "canonical_id": "security-reviewer",
+    "deprecated": true,
+    "replaced_by": "security-reviewer",
+    "path": ".agents/skills/vulnerability-scanner/SKILL.md",
+    "description": "Compatibility alias skill. Deprecated: use security-reviewer.",
     "triggers": []
   },
   {
+    "id": "web-design-guidelines",
     "name": "web-design-guidelines",
-    "path": ".agent/skills/web-design-guidelines/SKILL.md",
+    "canonical_id": "web-design-guidelines",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/web-design-guidelines/SKILL.md",
     "description": "Review UI code for Web Interface Guidelines compliance. Use when asked to \"review my UI\", \"check accessibility\", \"audit design\", \"review UX\", or \"check my site against best practices\".",
     "triggers": []
   },
   {
+    "id": "web-perf",
     "name": "web-perf",
-    "path": ".agent/skills/web-perf/SKILL.md",
+    "canonical_id": "web-perf",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/web-perf/SKILL.md",
     "description": "Analyzes web performance using Chrome DevTools MCP. Measures Core Web Vitals (FCP, LCP, TBT, CLS, Speed Index), identifies render-blocking resources, network dependency chains, layout shifts, caching issues, and accessibility gaps. Use when asked to audit, profile, debug, or optimize page load performance, Lighthouse scores, or site speed.",
     "triggers": []
   },
   {
+    "id": "webapp-testing",
     "name": "webapp-testing",
-    "path": ".agent/skills/webapp-testing/SKILL.md",
+    "canonical_id": "webapp-testing",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/webapp-testing/SKILL.md",
     "description": "Web application testing principles. E2E, Playwright, deep audit strategies.",
     "triggers": []
   },
   {
+    "id": "wrangler",
     "name": "wrangler",
-    "path": ".agent/skills/wrangler/SKILL.md",
+    "canonical_id": "wrangler",
+    "deprecated": false,
+    "replaced_by": null,
+    "path": ".agents/skills/wrangler/SKILL.md",
     "description": "Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices.",
     "triggers": []
-  },
-  {
-    "name": "database-design",
-    "path": ".agent/skills/database-design/SKILL.md",
-    "description": "Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.",
-    "triggers": []
-  },
-  {
-    "name": "database-optimizer",
-    "path": ".agent/skills/database-optimizer/SKILL.md",
-    "description": "Use for system-level database performance triage across engines: bottleneck analysis, indexing strategy, config tuning, partitioning, and lock contention.",
-    "triggers": []
-  },
-  {
-    "name": "drift-flutter",
-    "path": ".agent/skills/drift-flutter/SKILL.md",
-    "description": "Use when implementing Flutter local persistence with Drift: schema design, DAOs, migrations, transactions, and repository integration",
-    "triggers": []
   }
 ]