@cubis/foundry 0.3.63 → 0.3.65

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/javascript-pro/SKILL.md

@@ -1,15 +1,14 @@
 ---
 name: "javascript-pro"
-description: "Use for modern JavaScript architecture and implementation across browser, Node, and edge runtimes with ES2025+ practices."
+description: "Use for modern JavaScript architecture and implementation across browser, Node, and edge runtimes with runtime-aware production practices."
 license: MIT
 metadata:
   version: "2.0.0"
   domain: "language"
   role: "specialist"
   stack: "javascript"
-  baseline: "ES2025+"
+  baseline: "Runtime-policy baseline (Node/browser/edge)"
 ---
-
 # JavaScript Pro
 
 ## When to use
@@ -18,6 +17,12 @@ metadata:
 - Refactoring legacy JS toward modern modules and async flows.
 - Improving performance and reliability in browser/Node runtimes.
 
+## When not to use
+
+- Type-driven architecture work where TypeScript is the actual project language.
+- Database-only investigation with no JavaScript runtime behavior involved.
+- One-off shell automation that should remain shell-native.
+
 ## Core workflow
 
 1. Confirm runtime constraints (browser targets, Node/edge version).
@@ -40,6 +45,18 @@ metadata:
 - Use streams for large payloads to avoid memory spikes.
 - Use feature detection, not UA sniffing, in browser code.
 
+## Debugging and observability
+
+- Reproduce runtime-specific failures in the exact target environment: browser, Node, or edge.
+- Surface async failures with structured errors and explicit logging context.
+- Use performance tooling before redesigning hot paths or caching strategy.
+
+## Performance and reliability
+
+- Keep bundle/runtime boundaries explicit so shared code does not assume unavailable APIs.
+- Bound parallelism and cancellation for network-heavy flows.
+- Prefer streaming, chunking, and incremental parsing for large payloads.
+
 ## Avoid
 
 - Silent promise rejections.
@@ -48,8 +65,10 @@ metadata:
 
 ## Reference files
 
-- `references/modern-syntax.md`
-- `references/async-patterns.md`
-- `references/modules.md`
-- `references/browser-apis.md`
-- `references/node-essentials.md`
+| File | Load when |
+| --- | --- |
+| `references/modern-syntax.md` | Choosing modern syntax/features for current runtime targets. |
+| `references/async-patterns.md` | Cancellation, retries, concurrency, or promise orchestration needs detail. |
+| `references/modules.md` | ESM/CJS/module-boundary tradeoffs are in scope. |
+| `references/browser-apis.md` | Browser-specific APIs, capability checks, or UX/runtime constraints matter. |
+| `references/node-essentials.md` | Node runtime behavior, streams, files, or process concerns matter. |

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/kotlin-pro/SKILL.md

@@ -9,7 +9,6 @@ metadata:
   stack: "kotlin"
   baseline: "Kotlin 2.3 line (2.2.20+ compatible)"
 ---
-
 # Kotlin Pro
 
 ## When to use
@@ -18,6 +17,12 @@ metadata:
 - Designing coroutine-based async flows.
 - Improving null-safety and domain model clarity.
 
+## When not to use
+
+- Frontend-only work with no Kotlin/JVM/Android/shared module in scope.
+- Database-only tuning without Kotlin code changes.
+- Tiny scripts that should stay in existing project tooling.
+
 ## Core workflow
 
 1. Establish target platform (JVM/Android/multiplatform).
@@ -33,6 +38,24 @@ metadata:
 - Keep serialization and transport models separate from domain.
 - Use dependency boundaries that support modular testing.
 
+## Debugging and observability
+
+- Keep coroutine context, dispatcher use, and cancellation visible in logs/traces.
+- Reproduce lifecycle-related failures with focused tests before broader rewrites.
+- Prefer deterministic `Flow`/coroutine tests for race-prone logic.
+
+## Performance and reliability
+
+- Bound coroutine fan-out and avoid hidden blocking on default dispatchers.
+- Keep Android/shared/JVM boundaries explicit to avoid platform leakage.
+- Favor allocation-light data flows in hot paths and measure before micro-optimizing.
+
+## References
+
+| File | Load when |
+| --- | --- |
+| `references/operational-baseline.md` | You need Kotlin coroutine, modularity, testing, and production guardrails. |
+
 ## Avoid
 
 - Coroutine launches without lifecycle ownership.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/kotlin-pro/references/operational-baseline.md

@@ -0,0 +1,9 @@
+## Operational baseline
+
+Load when: coroutine ownership, modularity, testing, or production guardrails need explicit guidance.
+
+- Keep coroutine scope ownership explicit and lifecycle-aware.
+- Avoid hidden blocking on shared/default dispatchers.
+- Keep shared/domain modules isolated from platform-specific details.
+- Use deterministic tests for `Flow`, coroutine, and lifecycle behavior.
+- Prefer structured logs and traces that show dispatcher/cancellation context.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/legacy-modernizer/SKILL.md

@@ -12,7 +12,6 @@ metadata:
   output-format: code+analysis
   related-skills: test-master, devops-engineer
 ---
-
 # Legacy Modernizer
 
 Senior legacy modernization specialist with expertise in transforming aging systems into modern architectures without disrupting business operations.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/lint-and-validate/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: lint-and-validate
 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."
-allowed-tools: Read, Glob, Grep, Bash
 ---
-
 # Lint and Validate Skill
 
 > **MANDATORY:** Run appropriate validation tools after EVERY code change. Do not finish a task until the code is error-free.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/microservices-architect/SKILL.md

@@ -2,8 +2,6 @@
 name: "microservices-architect"
 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."
 ---
-
-
 # Microservices Architect
 
 ## Overview
@@ -83,11 +81,3 @@ When designing microservices architecture, provide:
 ## Knowledge Reference
 
 Domain-driven design, bounded contexts, event storming, REST/gRPC, message queues (Kafka, RabbitMQ), service mesh (Istio, Linkerd), Kubernetes, circuit breakers, saga patterns, event sourcing, CQRS, distributed tracing (Jaeger, Zipkin), API gateways, eventual consistency, CAP theorem
-
-## Related Powers
-
-- **DevOps Engineer** - Container orchestration and CI/CD pipelines
-- **Kubernetes Specialist** - Advanced K8s patterns and operators
-- **GraphQL Architect** - Federation for distributed schemas
-- **Architecture Designer** - High-level system design
-- **Monitoring Expert** - Observability implementation

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/mobile-design/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: mobile-design
 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.
-allowed-tools: Read, Glob, Grep, Bash
 ---
-
 # Mobile Design System
 
 > **Philosophy:** Touch-first. Battery-conscious. Platform-respectful. Offline-capable.
@@ -29,16 +27,16 @@ allowed-tools: Read, Glob, Grep, Bash
 
 | File | Content | Status |
 |------|---------|--------|
-| **[mobile-design-thinking.md](mobile-design-thinking.md)** | **⚠️ ANTI-MEMORIZATION: Forces thinking, prevents AI defaults** | **⬜ CRITICAL FIRST** |
-| **[touch-psychology.md](touch-psychology.md)** | **Fitts' Law, gestures, haptics, thumb zone** | **⬜ CRITICAL** |
-| **[mobile-performance.md](mobile-performance.md)** | **RN/Flutter performance, 60fps, memory** | **⬜ CRITICAL** |
-| **[mobile-backend.md](mobile-backend.md)** | **Push notifications, offline sync, mobile API** | **⬜ CRITICAL** |
-| **[mobile-testing.md](mobile-testing.md)** | **Testing pyramid, E2E, platform-specific** | **⬜ CRITICAL** |
-| **[mobile-debugging.md](mobile-debugging.md)** | **Native vs JS debugging, Flipper, Logcat** | **⬜ CRITICAL** |
-| [mobile-navigation.md](mobile-navigation.md) | Tab/Stack/Drawer, deep linking | ⬜ Read |
-| [mobile-typography.md](mobile-typography.md) | System fonts, Dynamic Type, a11y | ⬜ Read |
-| [mobile-color-system.md](mobile-color-system.md) | OLED, dark mode, battery-aware | ⬜ Read |
-| [decision-trees.md](decision-trees.md) | Framework/state/storage selection | ⬜ Read |
+| **[mobile-design-thinking.md](references/mobile-design-thinking.md)** | **⚠️ ANTI-MEMORIZATION: Forces thinking, prevents AI defaults** | **⬜ CRITICAL FIRST** |
+| **[touch-psychology.md](references/touch-psychology.md)** | **Fitts' Law, gestures, haptics, thumb zone** | **⬜ CRITICAL** |
+| **[mobile-performance.md](references/mobile-performance.md)** | **RN/Flutter performance, 60fps, memory** | **⬜ CRITICAL** |
+| **[mobile-backend.md](references/mobile-backend.md)** | **Push notifications, offline sync, mobile API** | **⬜ CRITICAL** |
+| **[mobile-testing.md](references/mobile-testing.md)** | **Testing pyramid, E2E, platform-specific** | **⬜ CRITICAL** |
+| **[mobile-debugging.md](references/mobile-debugging.md)** | **Native vs JS debugging, Flipper, Logcat** | **⬜ CRITICAL** |
+| [mobile-navigation.md](references/mobile-navigation.md) | Tab/Stack/Drawer, deep linking | ⬜ Read |
+| [mobile-typography.md](references/mobile-typography.md) | System fonts, Dynamic Type, a11y | ⬜ Read |
+| [mobile-color-system.md](references/mobile-color-system.md) | OLED, dark mode, battery-aware | ⬜ Read |
+| [decision-trees.md](references/decision-trees.md) | Framework/state/storage selection | ⬜ Read |
 
 > 🧠 **mobile-design-thinking.md is PRIORITY!** This file ensures AI thinks instead of using memorized patterns.
 
@@ -46,8 +44,8 @@ allowed-tools: Read, Glob, Grep, Bash
 
 | Platform | File | Content | When to Read |
 |----------|------|---------|--------------|
-| **iOS** | [platform-ios.md](platform-ios.md) | Human Interface Guidelines, SF Pro, SwiftUI patterns | Building for iPhone/iPad |
-| **Android** | [platform-android.md](platform-android.md) | Material Design 3, Roboto, Compose patterns | Building for Android |
+| **iOS** | [platform-ios.md](references/platform-ios.md) | Human Interface Guidelines, SF Pro, SwiftUI patterns | Building for iPhone/iPad |
+| **Android** | [platform-android.md](references/platform-android.md) | Material Design 3, Roboto, Compose patterns | Building for Android |
 | **Cross-Platform** | Both above | Platform divergence points | React Native / Flutter |
 
 > 🔴 **If building for iOS → Read platform-ios.md FIRST!**
@@ -193,7 +191,7 @@ Mobile:  Finger is imprecise (~7mm contact area)
 | Large viewport | Limited space, scroll vertical |
 | Stable attention | Interrupted constantly |
 
-For deep dive: [touch-psychology.md](touch-psychology.md)
+For deep dive: [touch-psychology.md](references/touch-psychology.md)
 
 ---
 
@@ -266,7 +264,7 @@ GPU-accelerated (FAST):     CPU-bound (SLOW):
                             └── (AVOID animating these)
 ```
 
-For complete guide: [mobile-performance.md](mobile-performance.md)
+For complete guide: [mobile-performance.md](references/mobile-performance.md)
 
 ---
 
@@ -336,7 +334,7 @@ WHAT ARE YOU BUILDING?
             └── ✅ Flutter
 ```
 
-For complete decision trees: [decision-trees.md](decision-trees.md)
+For complete decision trees: [decision-trees.md](references/decision-trees.md)
 
 ---
 
@@ -379,15 +377,15 @@ For deeper guidance on specific areas:
 
 | File | When to Use |
 |------|-------------|
-| [mobile-design-thinking.md](mobile-design-thinking.md) | **FIRST! Anti-memorization, forces context-based thinking** |
-| [touch-psychology.md](touch-psychology.md) | Understanding touch interaction, Fitts' Law, gesture design |
-| [mobile-performance.md](mobile-performance.md) | Optimizing RN/Flutter, 60fps, memory/battery |
-| [platform-ios.md](platform-ios.md) | iOS-specific design, HIG compliance |
-| [platform-android.md](platform-android.md) | Android-specific design, Material Design 3 |
-| [mobile-navigation.md](mobile-navigation.md) | Navigation patterns, deep linking |
-| [mobile-typography.md](mobile-typography.md) | Type scale, system fonts, accessibility |
-| [mobile-color-system.md](mobile-color-system.md) | OLED optimization, dark mode, battery |
-| [decision-trees.md](decision-trees.md) | Framework, state, storage decisions |
+| [mobile-design-thinking.md](references/mobile-design-thinking.md) | **FIRST! Anti-memorization, forces context-based thinking** |
+| [touch-psychology.md](references/touch-psychology.md) | Understanding touch interaction, Fitts' Law, gesture design |
+| [mobile-performance.md](references/mobile-performance.md) | Optimizing RN/Flutter, 60fps, memory/battery |
+| [platform-ios.md](references/platform-ios.md) | iOS-specific design, HIG compliance |
+| [platform-android.md](references/platform-android.md) | Android-specific design, Material Design 3 |
+| [mobile-navigation.md](references/mobile-navigation.md) | Navigation patterns, deep linking |
+| [mobile-typography.md](references/mobile-typography.md) | Type scale, system fonts, accessibility |
+| [mobile-color-system.md](references/mobile-color-system.md) | OLED optimization, dark mode, battery |
+| [decision-trees.md](references/decision-trees.md) | Framework, state, storage decisions |
 
 ---
 

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/monitoring-expert/SKILL.md

@@ -12,7 +12,6 @@ metadata:
   output-format: code
   related-skills: devops-engineer, debugging-wizard, architecture-designer
 ---
-
 # Monitoring Expert
 
 Observability and performance specialist implementing comprehensive monitoring, alerting, tracing, and performance testing systems.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nestjs-expert/SKILL.md

@@ -2,8 +2,6 @@
 name: "nestjs-expert"
 description: "Use when building NestJS applications requiring modular architecture, dependency injection, or TypeScript backend development. Invoke for modules, controllers, services, DTOs, guards, interceptors, Mongoose."
 ---
-
-
 # NestJS Expert
 
 ## Overview
@@ -14,7 +12,7 @@ Senior NestJS specialist with deep expertise in enterprise-grade, scalable TypeS
 
 You are a senior Node.js engineer with 10+ years of backend experience. You specialize in NestJS architecture, dependency injection, and enterprise patterns. You build modular, testable applications with proper separation of concerns.
 
-## When to Use This Power
+## When to Use This Skill
 
 - Building NestJS REST APIs with Fastify
 - Implementing modules, controllers, and services
@@ -105,10 +103,3 @@ When implementing NestJS features, provide:
 ## Knowledge Reference
 
 NestJS, TypeScript, Mongoose, Fastify, @fastify/secure-session, class-validator, class-transformer, Swagger/OpenAPI, Jest, Supertest, Guards, Interceptors, Pipes, Filters
-
-## Related Powers
-
-- **Fastify Patterns** - Fastify adapter and session configuration
-- **Mongoose NestJS** - MongoDB integration patterns
-- **Test Master** - Comprehensive testing strategies
-- **Security Reviewer** - Security auditing

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nestjs-expert/references/authentication.md

@@ -457,5 +457,5 @@ getMyOrg(@SessionUser('organizationId') orgId: string) {
 
 ## Related Reference Files
 
-- `references/secure-sessions.md` (Fastify Patterns) - Detailed session configuration
-- `references/services-di.md` - Dependency injection patterns
+- [secure-sessions.md](secure-sessions.md) (Fastify Patterns) - Detailed session configuration
+- [services-di.md](services-di.md) - Dependency injection patterns

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nestjs-expert/references/migration-from-express.md

@@ -989,7 +989,7 @@ describe('UsersController (e2e)', () => {
 
 Gradually replace Express routes with NestJS while both run simultaneously.
 
-**Cross-reference:** See `references/strangler-fig-pattern.md` for detailed implementation.
+**Cross-reference:** See [strangler-fig-pattern.md](strangler-fig-pattern.md) for detailed implementation.
 
 ```typescript
 // main.ts - Running both Express and NestJS

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nestjs-expert/references/secure-sessions.md

@@ -52,5 +52,5 @@ Do not store tokens, passwords, raw PII, or authorization policy blobs.
 
 ## Related
 
-- `references/authentication.md`
-- `references/services-di.md`
+- [authentication.md](authentication.md)
+- [services-di.md](services-di.md)

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nestjs-expert/references/strangler-fig-pattern.md

@@ -43,5 +43,5 @@ Move route groups from legacy to NestJS in controlled slices while preserving be
 
 ## Related
 
-- `references/migration-from-express.md`
-- `references/authentication.md`
+- [migration-from-express.md](migration-from-express.md)
+- [authentication.md](authentication.md)

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/next-best-practices/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: next-best-practices
 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."
-user-invocable: false
+metadata:
+  user-invocable: false
 ---
-
 # Next.js Best Practices
 
 Apply these rules when writing or reviewing Next.js code.
 
 ## File Conventions
 
-See [file-conventions.md](./file-conventions.md) for:
+See [file-conventions.md](references/file-conventions.md) for:
 - Project structure and special files
 - Route segments (dynamic, catch-all, groups)
 - Parallel and intercepting routes
@@ -20,7 +20,7 @@ See [file-conventions.md](./file-conventions.md) for:
 
 Detect invalid React Server Component patterns.
 
-See [rsc-boundaries.md](./rsc-boundaries.md) for:
+See [rsc-boundaries.md](references/rsc-boundaries.md) for:
 - Async client component detection (invalid)
 - Non-serializable props detection
 - Server Action exceptions
@@ -29,33 +29,33 @@ See [rsc-boundaries.md](./rsc-boundaries.md) for:
 
 Next.js 15+ async API changes.
 
-See [async-patterns.md](./async-patterns.md) for:
+See [async-patterns.md](references/async-patterns.md) for:
 - Async `params` and `searchParams`
 - Async `cookies()` and `headers()`
 - Migration codemod
 
 ## Runtime Selection
 
-See [runtime-selection.md](./runtime-selection.md) for:
+See [runtime-selection.md](references/runtime-selection.md) for:
 - Default to Node.js runtime
 - When Edge runtime is appropriate
 
 ## Directives
 
-See [directives.md](./directives.md) for:
+See [directives.md](references/directives.md) for:
 - `'use client'`, `'use server'` (React)
 - `'use cache'` (Next.js)
 
 ## Functions
 
-See [functions.md](./functions.md) for:
+See [functions.md](references/functions.md) for:
 - Navigation hooks: `useRouter`, `usePathname`, `useSearchParams`, `useParams`
 - Server functions: `cookies`, `headers`, `draftMode`, `after`
 - Generate functions: `generateStaticParams`, `generateMetadata`
 
 ## Error Handling
 
-See [error-handling.md](./error-handling.md) for:
+See [error-handling.md](references/error-handling.md) for:
 - `error.tsx`, `global-error.tsx`, `not-found.tsx`
 - `redirect`, `permanentRedirect`, `notFound`
 - `forbidden`, `unauthorized` (auth errors)
@@ -63,14 +63,14 @@ See [error-handling.md](./error-handling.md) for:
 
 ## Data Patterns
 
-See [data-patterns.md](./data-patterns.md) for:
+See [data-patterns.md](references/data-patterns.md) for:
 - Server Components vs Server Actions vs Route Handlers
 - Avoiding data waterfalls (`Promise.all`, Suspense, preload)
 - Client component data fetching
 
 ## Route Handlers
 
-See [route-handlers.md](./route-handlers.md) for:
+See [route-handlers.md](references/route-handlers.md) for:
 - `route.ts` basics
 - GET handler conflicts with `page.tsx`
 - Environment behavior (no React DOM)
@@ -78,7 +78,7 @@ See [route-handlers.md](./route-handlers.md) for:
 
 ## Metadata & OG Images
 
-See [metadata.md](./metadata.md) for:
+See [metadata.md](references/metadata.md) for:
 - Static and dynamic metadata
 - `generateMetadata` function
 - OG image generation with `next/og`
@@ -86,7 +86,7 @@ See [metadata.md](./metadata.md) for:
 
 ## Image Optimization
 
-See [image.md](./image.md) for:
+See [image.md](references/image.md) for:
 - Always use `next/image` over `<img>`
 - Remote images configuration
 - Responsive `sizes` attribute
@@ -95,7 +95,7 @@ See [image.md](./image.md) for:
 
 ## Font Optimization
 
-See [font.md](./font.md) for:
+See [font.md](references/font.md) for:
 - `next/font` setup
 - Google Fonts, local fonts
 - Tailwind CSS integration
@@ -103,7 +103,7 @@ See [font.md](./font.md) for:
 
 ## Bundling
 
-See [bundling.md](./bundling.md) for:
+See [bundling.md](references/bundling.md) for:
 - Server-incompatible packages
 - CSS imports (not link tags)
 - Polyfills (already included)
@@ -112,7 +112,7 @@ See [bundling.md](./bundling.md) for:
 
 ## Scripts
 
-See [scripts.md](./scripts.md) for:
+See [scripts.md](references/scripts.md) for:
 - `next/script` vs native script tags
 - Inline scripts need `id`
 - Loading strategies
@@ -120,34 +120,33 @@ See [scripts.md](./scripts.md) for:
 
 ## Hydration Errors
 
-See [hydration-error.md](./hydration-error.md) for:
+See [hydration-error.md](references/hydration-error.md) for:
 - Common causes (browser APIs, dates, invalid HTML)
 - Debugging with error overlay
 - Fixes for each cause
 
 ## Suspense Boundaries
 
-See [suspense-boundaries.md](./suspense-boundaries.md) for:
+See [suspense-boundaries.md](references/suspense-boundaries.md) for:
 - CSR bailout with `useSearchParams` and `usePathname`
 - Which hooks require Suspense boundaries
 
 ## Parallel & Intercepting Routes
 
-See [parallel-routes.md](./parallel-routes.md) for:
+See [parallel-routes.md](references/parallel-routes.md) for:
 - Modal patterns with `@slot` and `(.)` interceptors
 - `default.tsx` for fallbacks
 - Closing modals correctly with `router.back()`
 
 ## Self-Hosting
 
-See [self-hosting.md](./self-hosting.md) for:
+See [self-hosting.md](references/self-hosting.md) for:
 - `output: 'standalone'` for Docker
 - Cache handlers for multi-instance ISR
 - What works vs needs extra setup
 
 ## Debug Tricks
 
-See [debug-tricks.md](./debug-tricks.md) for:
+See [debug-tricks.md](references/debug-tricks.md) for:
 - MCP endpoint for AI-assisted debugging
 - Rebuild specific routes with `--debug-build-paths`
-

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/next-cache-components/SKILL.md

@@ -2,7 +2,6 @@
 name: next-cache-components
 description: "Use only for Next.js 16 Cache Components and PPR implementation (use cache, cacheLife, cacheTag, updateTag, Suspense boundaries)."
 ---
-
 # Cache Components (Next.js 16+)
 
 Cache Components enable Partial Prerendering (PPR) - mix static, cached, and dynamic content in a single route.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/next-upgrade/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: next-upgrade
 description: "Use only for upgrading Next.js versions with official migration guides and codemods; includes dependency/version planning and upgrade validation."
-argument-hint: "[target-version]"
+metadata:
+  argument-hint: "[target-version]"
 ---
-
 # Upgrade Next.js
 
 Upgrade the current project to the latest Next.js version following official migration guides.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nextjs-developer/SKILL.md

@@ -1,6 +1,5 @@
 ---
 name: "nextjs-developer"
-displayName: "Next.js Developer"
 description: "Use for implementing/refactoring Next.js App Router features, React Server Components/Actions, SEO, and production architecture."
 license: MIT
 metadata:
@@ -10,7 +9,6 @@ metadata:
   stack: "nextjs"
   baseline: "Next.js 16 + React 19"
 ---
-
 # Next.js Developer
 
 ## Scope

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nextjs-react-expert/SKILL.md

@@ -7,7 +7,6 @@ metadata:
   removal_target: "v0.6.0"
   alias_of: "react-best-practices"
 ---
-
 # nextjs-react-expert (Compatibility Alias)
 
 This skill is deprecated and kept for backward compatibility.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nodejs-best-practices/SKILL.md

@@ -9,7 +9,6 @@ metadata:
   stack: "nodejs"
   baseline: "Node 22/24 LTS era"
 ---
-
 # Node.js Best Practices
 
 ## Purpose

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/oneup-design/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: "oneup-design"
-displayName: "OneUp Design System"
 description: "OneUp HR design system with One* components, colors, spacing, and typography tokens"
-keywords: ["design", "ui", "component", "color", "spacing", "padding", "typography", "OneText", "OneButton", "OneCard", "widget", "theme"]
 ---
-
 # OneUp Design System
 
 ## Onboarding
@@ -16,9 +13,11 @@ import '../../../../core/design_system/one_design_system.dart';
 
 ## When to Load Steering Files
 
-- Working with colors → `colors.md`
-- Working with spacing/padding → `spacing.md`
-- Using One* components → `components.md`
+| File | Load when |
+| --- | --- |
+| `references/colors.md` | Choosing semantic colors, surface roles, and token-safe palette usage. |
+| `references/spacing.md` | Replacing hard-coded spacing/padding and aligning with token spacing rules. |
+| `references/components.md` | Selecting or reviewing One* components and their expected usage patterns. |
 
 ## MCP Tools (Use Before Writing UI)
 

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/openapi-docs/SKILL.md

@@ -2,8 +2,6 @@
 name: "openapi-docs"
 description: "Use when writing or updating OpenAPI specifications, defining request/response schemas, or configuring Stoplight Elements (Swagger-style) documentation UI."
 ---
-
-
 # OpenAPI Docs & Stoplight UI
 
 ## Overview

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/parallel-agents/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: parallel-agents
 description: Multi-agent orchestration patterns. Use when multiple independent tasks can run with different domain expertise or when comprehensive analysis requires multiple perspectives.
-allowed-tools: Read, Glob, Grep
 ---
-
 # Native Parallel Agents
 
 > Orchestration through Antigravity's built-in Agent Tool

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/performance-profiling/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: performance-profiling
 description: Performance profiling principles. Measurement, analysis, and optimization techniques.
-allowed-tools: Read, Glob, Grep, Bash
 ---
-
 # Performance Profiling
 
 > Measure, analyze, optimize - in that order.

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/plan-writing/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: plan-writing
 description: Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.
-allowed-tools: Read, Glob, Grep
 ---
-
 # Plan Writing
 
 > Source: obra/superpowers
@@ -31,7 +29,7 @@ This skill provides a framework for breaking down work into clear, actionable ta
 
 ### 4. Dynamic Naming in Project Root
 - Plan files are saved as `{task-slug}.md` in the PROJECT ROOT
-- Name derived from task (e.g., "add auth" → `auth-feature.md`)
+- Name derived from task (e.g., "add auth" -> auth-feature markdown plan in the project root)
 - **NEVER** inside `.claude/`, `docs/`, or temp folders
 
 ## Planning Principles (NOT Templates!)

package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-expert/SKILL.md

@@ -12,7 +12,6 @@ metadata:
   output-format: code
   related-skills: test-master, react-expert, devops-engineer
 ---
-
 # Playwright Expert
 
 Senior E2E testing specialist with deep expertise in Playwright for robust, maintainable browser automation.