com.wallstop-studios.dxmessaging 2.1.4 → 2.1.6

package/.llm/skills/github-actions/workflow-consistency.md

@@ -0,0 +1,346 @@
+---
+title: "GitHub Actions Workflow Consistency"
+id: "workflow-consistency"
+category: "github-actions"
+version: "1.0.0"
+created: "2026-01-28"
+updated: "2026-01-28"
+
+source:
+  repository: "wallstop/DxMessaging"
+  files:
+    - path: ".github/workflows/"
+  url: "https://github.com/wallstop/DxMessaging"
+
+tags:
+  - "github-actions"
+  - "ci-cd"
+  - "workflow"
+  - "security"
+  - "consistency"
+  - "yaml"
+
+complexity:
+  level: "intermediate"
+  reasoning: "Requires understanding of GitHub Actions features and security best practices"
+
+impact:
+  performance:
+    rating: "medium"
+    details: "Concurrency controls prevent resource waste from duplicate runs"
+  maintainability:
+    rating: "high"
+    details: "Consistent structure makes workflows easier to review and modify"
+  testability:
+    rating: "medium"
+    details: "Proper path filters ensure workflows run when needed"
+
+prerequisites:
+  - "Understanding of GitHub Actions workflow syntax"
+  - "Familiarity with YAML formatting"
+  - "Knowledge of security best practices for CI/CD"
+
+dependencies:
+  packages: []
+  skills:
+    - "cross-platform-compatibility"
+
+applies_to:
+  languages:
+    - "YAML"
+  frameworks:
+    - "GitHub Actions"
+  versions:
+    github-actions: "current"
+
+aliases:
+  - "Workflow standards"
+  - "CI/CD consistency"
+  - "Actions best practices"
+
+related:
+  - "cross-platform-compatibility"
+  - "shell-best-practices"
+  - "git-renormalize-patterns"
+
+status: "stable"
+---
+
+# GitHub Actions Workflow Consistency
+
+> **One-line summary**: Ensure all GitHub Actions workflows follow consistent structure,
+> security practices, and formatting to maintain reliability and reviewability.
+
+## Overview
+
+GitHub Actions workflows in this project must follow strict conventions for structure,
+security, and formatting. This skill documents the required patterns to ensure all workflows
+are consistent, secure, and maintainable.
+
+## Solution
+
+Apply these requirements to every workflow file:
+
+1. Use consistent property ordering: `name` → `on` → `concurrency` → `permissions` → `jobs`
+1. Always include a concurrency group with `cancel-in-progress: true`
+1. Declare explicit minimal permissions
+1. Set `timeout-minutes` on every job
+1. Use `persist-credentials: false` on checkout steps (unless pushing)
+1. Include `.github/workflows/**` in path filters for self-referential workflows
+1. Use double quotes for strings (Prettier default)
+
+## Required Property Order
+
+All workflow files MUST use this exact property ordering at the top level:
+
+```yaml
+name: Workflow Name
+
+on:
+  # triggers
+
+concurrency:
+  # concurrency settings
+
+permissions:
+  # permission declarations
+
+jobs:
+  # job definitions
+```
+
+### Why Order Matters
+
+1. **Readability**: Consistent ordering makes workflows scannable
+1. **Review efficiency**: Reviewers know where to find specific sections
+1. **Prettier compatibility**: Maintains formatting after auto-formatting
+
+## Required Elements
+
+Every workflow MUST include these elements:
+
+### 1. Concurrency Group
+
+Prevents duplicate workflow runs and cancels in-progress runs when new commits are pushed:
+
+```yaml
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+```
+
+### 2. Explicit Permissions
+
+Always declare the minimum required permissions. Default to read-only:
+
+```yaml
+# Read-only access (most workflows)
+permissions:
+  contents: read
+
+# For workflows that push changes
+permissions:
+  contents: write
+  pull-requests: write
+```
+
+**Never omit permissions**—implicit permissions are overly broad.
+
+### 3. Job Timeout
+
+Every job MUST have a `timeout-minutes` to prevent runaway jobs:
+
+```yaml
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10 # Required on every job
+```
+
+Recommended timeouts:
+
+- **Lint/format checks**: 5 minutes
+- **Build/compile**: 15-30 minutes
+- **Full test suites**: 30-60 minutes
+- **Deployment**: 10-15 minutes
+
+### 4. Secure Checkout
+
+Use `persist-credentials: false` on checkout steps unless credentials are explicitly needed:
+
+```yaml
+- name: Checkout
+  uses: actions/checkout@v6
+  with:
+    persist-credentials: false
+```
+
+Only omit this when the workflow needs to push commits (e.g., auto-fix workflows).
+
+## Path Filters
+
+### Self-Referential Workflows
+
+Workflows that check formatting or linting of specific file types MUST include
+`.github/workflows/**` in their path filters. This ensures the workflow runs when
+its own definition changes.
+
+```yaml
+on:
+  pull_request:
+    paths:
+      - "**/*.yml"
+      - "**/*.yaml"
+      - ".github/workflows/**" # Critical: include workflow files
+      - ".prettierrc*"
+      - "package.json"
+```
+
+### Common Path Filter Patterns
+
+| Workflow Type | Required Paths                                                                    |
+| ------------- | --------------------------------------------------------------------------------- |
+| YAML lint     | `**/*.yml`, `**/*.yaml`, `.github/workflows/**`, `.yamllint.yaml`, `.prettierrc*` |
+| Markdown lint | `**/*.md`, `**/*.markdown`, `.markdownlint*`, `package.json`                      |
+| JSON format   | `**/*.json`, `**/*.asmdef`, `**/*.asmref`, `.prettierrc*`                         |
+| C# build      | `**/*.cs`, `**/*.csproj`, `**/*.sln`, `Directory.Build.props`                     |
+| Tests         | Source paths + test paths + workflow config                                       |
+
+### Trigger Best Practices
+
+Include both `pull_request` and `push` triggers for validation workflows:
+
+```yaml
+on:
+  pull_request:
+    paths:
+      # file patterns
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      # same file patterns as pull_request
+  workflow_dispatch: # Allow manual triggering
+```
+
+## Formatting Requirements
+
+### Quote Style
+
+Use **double quotes** for all strings (matches Prettier YAML defaults):
+
+```yaml
+# Correct
+node-version: "20"
+cache: "npm"
+
+# Incorrect
+node-version: '20'
+cache: 'npm'
+```
+
+### Indentation
+
+Use **2 spaces** for YAML indentation (not 4):
+
+```yaml
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+```
+
+## Complete Workflow Template
+
+```yaml
+name: Example Workflow
+
+on:
+  pull_request:
+    paths:
+      - "**/*.ext"
+      - ".github/workflows/**"
+      - "config-file"
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "**/*.ext"
+      - ".github/workflows/**"
+      - "config-file"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  example-job:
+    name: Descriptive job name
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: package.json
+
+      - name: Install dependencies
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+          else
+            npm i --no-audit --no-fund
+          fi
+
+      - name: Run checks
+        run: npm run check
+```
+
+## Common Mistakes
+
+| Mistake                                 | Problem                                      | Fix                                               |
+| --------------------------------------- | -------------------------------------------- | ------------------------------------------------- |
+| Missing `.github/workflows/**` in paths | Workflow won't run when its own file changes | Add to path filters                               |
+| Missing concurrency group               | Duplicate runs waste resources               | Add concurrency block                             |
+| Missing permissions block               | Implicit permissions are too broad           | Declare explicit minimal permissions              |
+| Missing `persist-credentials: false`    | Git credentials persist unnecessarily        | Add to checkout step                              |
+| Missing `timeout-minutes`               | Jobs can run indefinitely                    | Add timeout to every job                          |
+| Single quotes for strings               | Inconsistent with Prettier                   | Use double quotes                                 |
+| Wrong property order                    | Hard to review, fails formatting             | Use: name → on → concurrency → permissions → jobs |
+
+## Validation Checklist
+
+Before committing a workflow, verify:
+
+- [ ] Properties ordered: `name` → `on` → `concurrency` → `permissions` → `jobs`
+- [ ] Concurrency group defined with `cancel-in-progress: true`
+- [ ] Explicit `permissions` block with minimal required permissions
+- [ ] Every job has `timeout-minutes`
+- [ ] Checkout steps use `persist-credentials: false` (unless pushing)
+- [ ] Path filters include `.github/workflows/**` for self-referential checks
+- [ ] Double quotes used for strings
+- [ ] 2-space indentation throughout
+
+## See Also
+
+- [Git Renormalize Pattern Validation](./git-renormalize-patterns.md) — ensuring pathspec patterns
+  match actual repository files to prevent CI failures
+- [Cross-Platform Compatibility](../scripting/cross-platform-compatibility.md) — handling platform
+  differences in CI scripts
+- [Shell Best Practices](../scripting/shell-best-practices.md) — patterns for shell commands in
+  workflow steps

package/.llm/skills/index.md

@@ -0,0 +1,257 @@
+# Skills Index
+
+> **Auto-generated** on 2026-01-30. Do not edit manually.
+> Run `node scripts/generate-skills-index.js` to regenerate.
+
+---
+
+## Summary
+
+| Metric       | Value |
+| ------------ | ----- |
+| Total Skills | 86    |
+| Categories   | 6     |
+| Unique Tags  | 162   |
+
+---
+
+## Table of Contents
+
+- [Documentation](#documentation) (15)
+- [GitHub Actions](#github-actions) (2)
+- [Performance](#performance) (24)
+- [Scripting](#scripting) (6)
+- [Solid](#solid) (13)
+- [Testing](#testing) (26)
+- [Tag Cloud](#tag-cloud)
+- [All Skills by Complexity](#all-skills-by-complexity)
+
+---
+
+## Documentation
+
+| Skill                                                                                       | Lines  | Complexity      | Status    | Performance | Tags                                      |
+| ------------------------------------------------------------------------------------------- | ------ | --------------- | --------- | ----------- | ----------------------------------------- |
+| [Changelog Entry Writing and Anti-Patterns](./documentation/changelog-entry-writing.md)     | ✅ 278 | 🟢 Basic        | ✅ Stable | ○○○○○       | changelog, release-notes, writing         |
+| [Changelog Management](./documentation/changelog-management.md)                             | ✅ 229 | 🟢 Basic        | ✅ Stable | ○○○○○       | changelog, documentation, versioning      |
+| [Changelog Release Workflow](./documentation/changelog-release-workflow.md)                 | ✅ 250 | 🟢 Basic        | ✅ Stable | ○○○○○       | changelog, release-workflow, versioning   |
+| [Documentation Code Samples](./documentation/documentation-code-samples.md)                 | ✅ 263 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, code-samples, examples     |
+| [Documentation Style Guide](./documentation/documentation-style-guide.md)                   | ✅ 204 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, style, writing             |
+| [Documentation Update Workflow](./documentation/documentation-update-workflow.md)           | 📝 149 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, workflow, checklist        |
+| [Documentation Updates and Maintenance](./documentation/documentation-updates.md)           | 📝 149 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, code-comments, xml-docs    |
+| [External URL Fragment Validation](./documentation/external-url-fragment-validation.md)     | 📝 182 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, links, urls                |
+| [GitHub Actions Version Consistency](./documentation/github-actions-version-consistency.md) | ✅ 204 | 🟢 Basic        | ✅ Stable | ○○○○○       | github-actions, ci-cd, version-management |
+| [Link Quality and External URL Management](./documentation/link-quality-guidelines.md)      | ✅ 268 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, links, urls                |
+| [Markdown Compatibility Guidelines](./documentation/markdown-compatibility.md)              | ⚠️ 477 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, markdown, compatibility    |
+| [Mermaid Diagram Theming](./documentation/mermaid-theming.md)                               | ✅ 327 | 🟡 Intermediate | ✅ Stable | ○○○○○       | documentation, mermaid, theming           |
+| [MkDocs Navigation Management](./documentation/mkdocs-navigation.md)                        | ✅ 291 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, mkdocs, navigation         |
+| [Skill File Sizing Guidelines](./documentation/skill-file-sizing.md)                        | ✅ 261 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, skills, file-organization  |
+| [XML Documentation Standards](./documentation/documentation-xml-docs.md)                    | 📝 191 | 🟢 Basic        | ✅ Stable | ○○○○○       | documentation, xml-docs, api-reference    |
+
+## GitHub Actions
+
+| Skill                                                                              | Lines  | Complexity      | Status    | Performance | Tags                            |
+| ---------------------------------------------------------------------------------- | ------ | --------------- | --------- | ----------- | ------------------------------- |
+| [Git Renormalize Pattern Validation](./github-actions/git-renormalize-patterns.md) | ✅ 232 | 🟡 Intermediate | ✅ Stable | ●○○○○       | github-actions, git, ci-cd      |
+| [GitHub Actions Workflow Consistency](./github-actions/workflow-consistency.md)    | ✅ 347 | 🟡 Intermediate | ✅ Stable | ●●○○○       | github-actions, ci-cd, workflow |
+
+## Performance
+
+| Skill                                                                                                           | Lines  | Complexity      | Status    | Performance | Tags                                   |
+| --------------------------------------------------------------------------------------------------------------- | ------ | --------------- | --------- | ----------- | -------------------------------------- |
+| [AggressiveInlining for Hot Path Optimization](./performance/aggressive-inlining.md)                            | ✅ 343 | 🟡 Intermediate | ✅ Stable | ●●○○○       | performance, inlining, optimization    |
+| [AggressiveInlining Performance Notes](./performance/aggressive-inlining-performance-notes.md)                  | 📝 95  | 🟡 Intermediate | ✅ Stable | ●●○○○       | performance, inlining, optimization    |
+| [Array Pooling Usage Examples](./performance/array-pooling-usage-examples.md)                                   | 📝 146 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [Array Pooling with ArrayPool and Custom Pools](./performance/array-pooling.md)                                 | ✅ 316 | 🟡 Intermediate | ✅ Stable | ●●●●●       | memory, allocation, pooling            |
+| [Auto-Load Singleton Attribute](./performance/singleton-autoload.md)                                            | 📝 112 | 🟡 Intermediate | ✅ Stable | ●○○○○       | unity, singleton, patterns             |
+| [Cache Builder Configuration](./performance/cache-eviction-builder.md)                                          | ✅ 204 | 🟡 Intermediate | ✅ Stable | ●●●○○       | caching, builder, configuration        |
+| [Cache Eviction Implementation](./performance/cache-eviction-implementation.md)                                 | ✅ 341 | 🟠 Advanced     | ✅ Stable | ●●●○○       | caching, eviction, lru                 |
+| [Collection Pooling with RAII Pattern](./performance/collection-pooling.md)                                     | ✅ 314 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [High-Performance Cache with Eviction Policies](./performance/cache-eviction-policies.md)                       | 📝 177 | 🟠 Advanced     | ✅ Stable | ●●●○○       | caching, memory, performance           |
+| [Object Pooling Anti-Patterns](./performance/object-pooling-anti-patterns.md)                                   | 📝 145 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [Object Pooling for Zero-Allocation Messaging](./performance/object-pooling.md)                                 | ✅ 320 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, garbage-collection |
+| [Object Pooling Usage Examples](./performance/object-pooling-usage-examples.md)                                 | 📝 115 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [Object Pooling Variations](./performance/object-pooling-variations.md)                                         | 📝 148 | 🟡 Intermediate | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [Readonly Struct Cached Hash Performance Notes](./performance/readonly-struct-cached-hash-performance-notes.md) | 📝 92  | 🟡 Intermediate | ✅ Stable | ●●●○○       | performance, struct, hashcode          |
+| [Readonly Struct with Cached Hash for Dictionary Keys](./performance/readonly-struct-cached-hash.md)            | ✅ 338 | 🟡 Intermediate | ✅ Stable | ●●●○○       | performance, struct, hashcode          |
+| [Runtime Singleton Pattern](./performance/singleton-runtime.md)                                                 | 📝 188 | 🟡 Intermediate | ✅ Stable | ●○○○○       | unity, singleton, patterns             |
+| [RuntimeSingleton and ScriptableObject Singleton Patterns](./performance/singleton-patterns.md)                 | 📝 166 | 🟡 Intermediate | ✅ Stable | ●●○○○       | unity, singleton, patterns             |
+| [ScriptableObject Singleton Pattern](./performance/singleton-scriptableobject.md)                               | 📝 178 | 🟡 Intermediate | ✅ Stable | ●○○○○       | unity, singleton, patterns             |
+| [Serializable Dictionary for Unity Inspector](./performance/serializable-dictionary.md)                         | ✅ 282 | 🟡 Intermediate | ✅ Stable | ●○○○○       | unity, serialization, dictionary       |
+| [Serializable Dictionary Property Drawer](./performance/serializable-dictionary-property-drawer.md)             | 📝 148 | 🟡 Intermediate | ✅ Stable | ●●○○○       | unity, serialization, dictionary       |
+| [Serializable Dictionary Usage Examples](./performance/serializable-dictionary-usage-examples.md)               | 📝 136 | 🟡 Intermediate | ✅ Stable | ●●○○○       | unity, serialization, dictionary       |
+| [Singleton Usage Examples](./performance/singleton-usage-examples.md)                                           | 📝 140 | 🟡 Intermediate | ✅ Stable | ●○○○○       | unity, singleton, patterns             |
+| [StringBuilder Pooling for Zero-Allocation String Building](./performance/stringbuilder-pooling.md)             | ✅ 320 | 🟢 Basic        | ✅ Stable | ●●●○○       | memory, allocation, pooling            |
+| [WaitForSeconds and Yield Instruction Pooling](./performance/yield-instruction-pooling.md)                      | ✅ 348 | 🟢 Basic        | ✅ Stable | ●●●○○       | performance, unity, coroutines         |
+
+## Scripting
+
+| Skill                                                                                      | Lines  | Complexity      | Status    | Performance | Tags                                      |
+| ------------------------------------------------------------------------------------------ | ------ | --------------- | --------- | ----------- | ----------------------------------------- |
+| [Cross-Platform Script Compatibility](./scripting/cross-platform-compatibility.md)         | ✅ 225 | 🟡 Intermediate | ✅ Stable | ○○○○○       | cross-platform, case-sensitivity, testing |
+| [JavaScript Code Quality Practices](./scripting/javascript-code-quality.md)                | ⚠️ 418 | 🟡 Intermediate | ✅ Stable | ○○○○○       | javascript, code-quality, linting         |
+| [PowerShell Scripting Best Practices](./scripting/powershell-best-practices.md)            | ⚠️ 387 | 🟡 Intermediate | ✅ Stable | ○○○○○       | powershell, scripting, regex              |
+| [Regex Pattern Documentation](./scripting/regex-documentation.md)                          | ⚠️ 462 | 🟡 Intermediate | ✅ Stable | ○○○○○       | regex, documentation, scripting           |
+| [Shell Scripting Best Practices](./scripting/shell-best-practices.md)                      | ⚠️ 387 | 🟡 Intermediate | ✅ Stable | ○○○○○       | shell, bash, scripting                    |
+| [Validation Patterns and Duplicate Warning Prevention](./scripting/validation-patterns.md) | ⚠️ 419 | 🟡 Intermediate | ✅ Stable | ○○○○○       | validation, javascript, error-handling    |
+
+## Solid
+
+| Skill                                                                                              | Lines  | Complexity      | Status    | Performance | Tags                                 |
+| -------------------------------------------------------------------------------------------------- | ------ | --------------- | --------- | ----------- | ------------------------------------ |
+| [Collection Extension Methods with Performance Documentation](./solid/collection-extensions.md)    | 📝 145 | 🟡 Intermediate | ✅ Stable | ●●●○○       | solid, extensions, collections       |
+| [Collection Extensions: Accessors](./solid/collection-extensions-accessors.md)                     | ✅ 230 | 🟡 Intermediate | ✅ Stable | ●●●○○       | collections, extensions, try-pattern |
+| [Collection Extensions: Shuffle](./solid/collection-extensions-shuffle.md)                         | 📝 145 | 🟢 Basic        | ✅ Stable | ●●○○○       | collections, shuffle, fisher-yates   |
+| [Collection Extensions: Type Specialization](./solid/collection-extensions-type-specialization.md) | 📝 169 | 🟡 Intermediate | ✅ Stable | ●●●○○       | collections, extensions, performance |
+| [Fluent Builder Pattern with Struct Builders](./solid/fluent-builder-pattern.md)                   | ✅ 323 | 🟡 Intermediate | ✅ Stable | ●●○○○       | solid, patterns, builder             |
+| [Fluent Builder Templates and Factories](./solid/fluent-builder-pattern-templates.md)              | 📝 118 | 🟡 Intermediate | ✅ Stable | ●●○○○       | solid, patterns, builder             |
+| [Fluent Builder Usage Examples](./solid/fluent-builder-pattern-usage-examples.md)                  | 📝 129 | 🟡 Intermediate | ✅ Stable | ●●○○○       | solid, patterns, builder             |
+| [IEquatable Implementation for Value Types](./solid/iequatable-implementation.md)                  | ✅ 240 | 🟡 Intermediate | ✅ Stable | ●●●○○       | solid, performance, struct           |
+| [IEquatable Implementation Variants](./solid/iequatable-implementation-variants.md)                | ✅ 202 | 🟡 Intermediate | ✅ Stable | ●●○○○       | solid, performance, struct           |
+| [IEquatable Usage Examples](./solid/iequatable-implementation-usage.md)                            | 📝 112 | 🟡 Intermediate | ✅ Stable | ●●○○○       | solid, performance, struct           |
+| [Try-Pattern API Usage Examples](./solid/try-pattern-apis-usage.md)                                | 📝 137 | 🟢 Basic        | ✅ Stable | ●●○○○       | solid, defensive, api-design         |
+| [Try-Pattern API Variants](./solid/try-pattern-apis-variants.md)                                   | ✅ 234 | 🟢 Basic        | ✅ Stable | ●●○○○       | solid, defensive, api-design         |
+| [Try-Pattern APIs for Defensive Programming](./solid/try-pattern-apis.md)                          | ✅ 221 | 🟢 Basic        | ✅ Stable | ●●●○○       | solid, defensive, api-design         |
+
+## Testing
+
+| Skill                                                                                             | Lines  | Complexity      | Status    | Performance | Tags                                        |
+| ------------------------------------------------------------------------------------------------- | ------ | --------------- | --------- | ----------- | ------------------------------------------- |
+| [Comprehensive Test Coverage Requirements](./testing/comprehensive-test-coverage.md)              | 📝 142 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, coverage, edge-cases               |
+| [Data-Driven Coverage Patterns](./testing/test-coverage-data-driven.md)                           | 📝 173 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, data-driven, nunit                 |
+| [Data-Driven Test Sources](./testing/data-driven-tests-sources.md)                                | ✅ 256 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, parameterized, data-driven         |
+| [Data-Driven Test Usage Patterns](./testing/data-driven-tests-usage.md)                           | 📝 108 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, parameterized, data-driven         |
+| [Data-Driven Tests with TestCaseSource](./testing/data-driven-tests.md)                           | 📝 198 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, parameterized, data-driven         |
+| [Git and Parser Robustness in CI/CD](./testing/git-workflow-robustness.md)                        | ⚠️ 370 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, git, ci-cd                         |
+| [Script Test Coverage Requirements](./testing/script-test-coverage.md)                            | ✅ 260 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, scripts, jest                      |
+| [Shared Fixtures: Generic Base](./testing/shared-test-fixtures-generic-base.md)                   | 📝 186 | 🟠 Advanced     | ✅ Stable | ●●●○○       | testing, fixtures, generic                  |
+| [Shared Fixtures: Reference Counting](./testing/shared-test-fixtures-reference-counting.md)       | ✅ 253 | 🟠 Advanced     | ✅ Stable | ●●●○○       | testing, fixtures, reference-counting       |
+| [Shared Test Fixtures with Reference Counting](./testing/shared-test-fixtures.md)                 | 📝 166 | 🟠 Advanced     | ✅ Stable | ●●●○○       | testing, fixtures, performance              |
+| [Test Base Class Cleanup Usage](./testing/test-base-class-cleanup-usage.md)                       | ✅ 219 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, cleanup, lifecycle                 |
+| [Test Base Class with Automatic Resource Cleanup](./testing/test-base-class-cleanup.md)           | ✅ 324 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, cleanup, lifecycle                 |
+| [Test Categories for Selective Execution](./testing/test-categories.md)                           | ✅ 288 | 🟢 Basic        | ✅ Stable | ●●●○○       | testing, organization, categories           |
+| [Test Category Execution](./testing/test-categories-execution.md)                                 | 📝 143 | 🟢 Basic        | ✅ Stable | ○○○○○       | testing, organization, categories           |
+| [Test Code Quality and Accuracy](./testing/test-code-quality.md)                                  | ✅ 244 | 🟡 Intermediate | ✅ Stable | ●●○○○       | testing, documentation, linting             |
+| [Test Coverage Scenario Categories](./testing/test-coverage-scenario-categories.md)               | ✅ 224 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, coverage, edge-cases               |
+| [Test Diagnostics and Investigation Patterns](./testing/test-diagnostics.md)                      | ✅ 248 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, diagnostics, debugging             |
+| [Test Diagnostics Patterns](./testing/test-diagnostics-patterns.md)                               | 📝 190 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, diagnostics, logging               |
+| [Test Diagnostics Usage](./testing/test-diagnostics-usage.md)                                     | 📝 197 | 🟡 Intermediate | ✅ Stable | ●○○○○       | testing, diagnostics, logging               |
+| [Test Failure Investigation and Zero-Flaky Policy](./testing/test-failure-investigation.md)       | 📝 120 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, investigation, debugging           |
+| [Test Failure Investigation Procedure](./testing/test-failure-investigation-procedure.md)         | ✅ 217 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, investigation, procedure           |
+| [Test Failure Root Causes and Anti-Patterns](./testing/test-failure-investigation-root-causes.md) | 📝 187 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, root-cause-analysis, anti-patterns |
+| [Test Invalid Skill](./testing/test-invalid-skill.md)                                             | 📝 27  | 🔴 Expert       | ✅ Stable | ●●●○○       |                                             |
+| [Test Organization and Assertions](./testing/test-coverage-organization-assertions.md)            | 📝 172 | 🟢 Basic        | ✅ Stable | ○○○○○       | testing, assertions, naming                 |
+| [Test Production Code Directly](./testing/test-production-code.md)                                | ✅ 349 | 🟡 Intermediate | ✅ Stable | ○○○○○       | testing, anti-patterns, code-quality        |
+| [Unity Test Considerations and Anti-Patterns](./testing/test-coverage-unity-anti-patterns.md)     | ✅ 233 | 🟢 Basic        | ✅ Stable | ○○○○○       | testing, unity, anti-patterns               |
+
+---
+
+## Tag Cloud
+
+`testing`×30 `documentation`×16 `performance`×15 `unity`×13 `ci-cd`×10 `patterns`×10 `solid`×10 `memory`×9 `pooling`×9 `allocation`×8 `nunit`×8 `zero-alloc`×7 `javascript`×6 `anti-patterns`×5 `collections`×5 `data-driven`×5 `debugging`×5 `linting`×5 `singleton`×5 `struct`×5 `builder`×4 `coverage`×4 `dictionary`×4 `fixtures`×4 `github-actions`×4 `markdown`×4 `versioning`×4 `api-design`×3 `caching`×3 `changelog`×3 `code-quality`×3 `defensive`×3 `diagnostics`×3 `equality`×3 `error-handling`×3 `extensions`×3 `fluent-api`×3 `inspector`×3 `investigation`×3 `keep-a-changelog`×3 `logging`×3 `messaging`×3 `mkdocs`×3 `organization`×3 `parameterized`×3 `powershell`×3 `quality`×3 `reference-counting`×3 `scripting`×3 `serialization`×3 `try-pattern`×3 `api-reference`×2 `arrays`×2 `benchmark`×2 `best-practices`×2 `case-sensitivity`×2 `categories`×2 `ci`×2 `cleanup`×2 `code-comments`×2 `code-samples`×2 `data-structures`×2 `edge-cases`×2 `eviction`×2 `examples`×2 `git`×2 `hashcode`×2 `hot-path`×2 `iequatable`×2 `inlining`×2 `jest`×2 `lfu`×2 `lifecycle`×2 `links`×2 `linux`×2 `lru`×2 `maintainability`×2 `maintenance`×2 `optimization`×2 `regex`×2 `release-notes`×2 `root-cause-analysis`×2 `urls`×2 `user-communication`×2 `validation`×2 `workflow`×2 `workflows`×2 `writing`×2 `xml-docs`×2 `yaml`×2 `accessibility`×1 `accuracy`×1 `architecture`×1 `arraypool`×1 `assertions`×1 `automation`×1 `bash`×1 `boxing`×1 `buffers`×1 `checklist`×1 `clarity`×1 `comments`×1 `compatibility`×1 `configuration`×1 `consistency`×1 `coroutines`×1 `cross-platform`×1 `diagrams`×1 `disposable`×1 `dry`×1 `duplicate-warnings`×1 `encoding`×1 `enum-validation`×1 `eslint`×1 `file-organization`×1 `fisher-yates`×1 `flaky-tests`×1 `fragments`×1 `garbage-collection`×1 `generic`×1 `gitattributes`×1 `here-strings`×1 `implementation`×1 `line-endings`×1 `llm-context`×1 `macos`×1 `mermaid`×1 `methodimpl`×1 `naming`×1 `navigation`×1 `negative-tests`×1 `optional-fields`×1 `parsing`×1 `portability`×1 `pre-commit`×1 `procedure`×1 `raii`×1 `release-workflow`×1 `scriptable-object`×1 `scripts`×1 `security`×1 `semantic-versioning`×1 `shared-state`×1 `shell`×1 `shuffle`×1 `site-structure`×1 `skills`×1 `stringbuilder`×1 `strings`×1 `style`×1 `sync-notes`×1 `test-cases`×1 `testability`×1 `theming`×1 `thread-safety`×1 `truthiness`×1 `type-coercion`×1 `type-specialization`×1 `version-management`×1 `windows`×1 `yield`×1 `zero-flaky`×1
+
+---
+
+## All Skills by Complexity
+
+### 🟢 Basic
+
+- [Changelog Entry Writing and Anti-Patterns](./documentation/changelog-entry-writing.md) _(documentation)_
+- [Changelog Management](./documentation/changelog-management.md) _(documentation)_
+- [Changelog Release Workflow](./documentation/changelog-release-workflow.md) _(documentation)_
+- [Collection Extensions: Shuffle](./solid/collection-extensions-shuffle.md) _(solid)_
+- [Documentation Code Samples](./documentation/documentation-code-samples.md) _(documentation)_
+- [Documentation Style Guide](./documentation/documentation-style-guide.md) _(documentation)_
+- [Documentation Update Workflow](./documentation/documentation-update-workflow.md) _(documentation)_
+- [Documentation Updates and Maintenance](./documentation/documentation-updates.md) _(documentation)_
+- [External URL Fragment Validation](./documentation/external-url-fragment-validation.md) _(documentation)_
+- [GitHub Actions Version Consistency](./documentation/github-actions-version-consistency.md) _(documentation)_
+- [Link Quality and External URL Management](./documentation/link-quality-guidelines.md) _(documentation)_
+- [Markdown Compatibility Guidelines](./documentation/markdown-compatibility.md) _(documentation)_
+- [MkDocs Navigation Management](./documentation/mkdocs-navigation.md) _(documentation)_
+- [Skill File Sizing Guidelines](./documentation/skill-file-sizing.md) _(documentation)_
+- [StringBuilder Pooling for Zero-Allocation String Building](./performance/stringbuilder-pooling.md) _(performance)_
+- [Test Categories for Selective Execution](./testing/test-categories.md) _(testing)_
+- [Test Category Execution](./testing/test-categories-execution.md) _(testing)_
+- [Test Organization and Assertions](./testing/test-coverage-organization-assertions.md) _(testing)_
+- [Try-Pattern API Usage Examples](./solid/try-pattern-apis-usage.md) _(solid)_
+- [Try-Pattern API Variants](./solid/try-pattern-apis-variants.md) _(solid)_
+- [Try-Pattern APIs for Defensive Programming](./solid/try-pattern-apis.md) _(solid)_
+- [Unity Test Considerations and Anti-Patterns](./testing/test-coverage-unity-anti-patterns.md) _(testing)_
+- [WaitForSeconds and Yield Instruction Pooling](./performance/yield-instruction-pooling.md) _(performance)_
+- [XML Documentation Standards](./documentation/documentation-xml-docs.md) _(documentation)_
+
+### 🟡 Intermediate
+
+- [AggressiveInlining for Hot Path Optimization](./performance/aggressive-inlining.md) _(performance)_
+- [AggressiveInlining Performance Notes](./performance/aggressive-inlining-performance-notes.md) _(performance)_
+- [Array Pooling Usage Examples](./performance/array-pooling-usage-examples.md) _(performance)_
+- [Array Pooling with ArrayPool and Custom Pools](./performance/array-pooling.md) _(performance)_
+- [Auto-Load Singleton Attribute](./performance/singleton-autoload.md) _(performance)_
+- [Cache Builder Configuration](./performance/cache-eviction-builder.md) _(performance)_
+- [Collection Extension Methods with Performance Documentation](./solid/collection-extensions.md) _(solid)_
+- [Collection Extensions: Accessors](./solid/collection-extensions-accessors.md) _(solid)_
+- [Collection Extensions: Type Specialization](./solid/collection-extensions-type-specialization.md) _(solid)_
+- [Collection Pooling with RAII Pattern](./performance/collection-pooling.md) _(performance)_
+- [Comprehensive Test Coverage Requirements](./testing/comprehensive-test-coverage.md) _(testing)_
+- [Cross-Platform Script Compatibility](./scripting/cross-platform-compatibility.md) _(scripting)_
+- [Data-Driven Coverage Patterns](./testing/test-coverage-data-driven.md) _(testing)_
+- [Data-Driven Test Sources](./testing/data-driven-tests-sources.md) _(testing)_
+- [Data-Driven Test Usage Patterns](./testing/data-driven-tests-usage.md) _(testing)_
+- [Data-Driven Tests with TestCaseSource](./testing/data-driven-tests.md) _(testing)_
+- [Fluent Builder Pattern with Struct Builders](./solid/fluent-builder-pattern.md) _(solid)_
+- [Fluent Builder Templates and Factories](./solid/fluent-builder-pattern-templates.md) _(solid)_
+- [Fluent Builder Usage Examples](./solid/fluent-builder-pattern-usage-examples.md) _(solid)_
+- [Git and Parser Robustness in CI/CD](./testing/git-workflow-robustness.md) _(testing)_
+- [Git Renormalize Pattern Validation](./github-actions/git-renormalize-patterns.md) _(github-actions)_
+- [GitHub Actions Workflow Consistency](./github-actions/workflow-consistency.md) _(github-actions)_
+- [IEquatable Implementation for Value Types](./solid/iequatable-implementation.md) _(solid)_
+- [IEquatable Implementation Variants](./solid/iequatable-implementation-variants.md) _(solid)_
+- [IEquatable Usage Examples](./solid/iequatable-implementation-usage.md) _(solid)_
+- [JavaScript Code Quality Practices](./scripting/javascript-code-quality.md) _(scripting)_
+- [Mermaid Diagram Theming](./documentation/mermaid-theming.md) _(documentation)_
+- [Object Pooling Anti-Patterns](./performance/object-pooling-anti-patterns.md) _(performance)_
+- [Object Pooling for Zero-Allocation Messaging](./performance/object-pooling.md) _(performance)_
+- [Object Pooling Usage Examples](./performance/object-pooling-usage-examples.md) _(performance)_
+- [Object Pooling Variations](./performance/object-pooling-variations.md) _(performance)_
+- [PowerShell Scripting Best Practices](./scripting/powershell-best-practices.md) _(scripting)_
+- [Readonly Struct Cached Hash Performance Notes](./performance/readonly-struct-cached-hash-performance-notes.md) _(performance)_
+- [Readonly Struct with Cached Hash for Dictionary Keys](./performance/readonly-struct-cached-hash.md) _(performance)_
+- [Regex Pattern Documentation](./scripting/regex-documentation.md) _(scripting)_
+- [Runtime Singleton Pattern](./performance/singleton-runtime.md) _(performance)_
+- [RuntimeSingleton and ScriptableObject Singleton Patterns](./performance/singleton-patterns.md) _(performance)_
+- [Script Test Coverage Requirements](./testing/script-test-coverage.md) _(testing)_
+- [ScriptableObject Singleton Pattern](./performance/singleton-scriptableobject.md) _(performance)_
+- [Serializable Dictionary for Unity Inspector](./performance/serializable-dictionary.md) _(performance)_
+- [Serializable Dictionary Property Drawer](./performance/serializable-dictionary-property-drawer.md) _(performance)_
+- [Serializable Dictionary Usage Examples](./performance/serializable-dictionary-usage-examples.md) _(performance)_
+- [Shell Scripting Best Practices](./scripting/shell-best-practices.md) _(scripting)_
+- [Singleton Usage Examples](./performance/singleton-usage-examples.md) _(performance)_
+- [Test Base Class Cleanup Usage](./testing/test-base-class-cleanup-usage.md) _(testing)_
+- [Test Base Class with Automatic Resource Cleanup](./testing/test-base-class-cleanup.md) _(testing)_
+- [Test Code Quality and Accuracy](./testing/test-code-quality.md) _(testing)_
+- [Test Coverage Scenario Categories](./testing/test-coverage-scenario-categories.md) _(testing)_
+- [Test Diagnostics and Investigation Patterns](./testing/test-diagnostics.md) _(testing)_
+- [Test Diagnostics Patterns](./testing/test-diagnostics-patterns.md) _(testing)_
+- [Test Diagnostics Usage](./testing/test-diagnostics-usage.md) _(testing)_
+- [Test Failure Investigation and Zero-Flaky Policy](./testing/test-failure-investigation.md) _(testing)_
+- [Test Failure Investigation Procedure](./testing/test-failure-investigation-procedure.md) _(testing)_
+- [Test Failure Root Causes and Anti-Patterns](./testing/test-failure-investigation-root-causes.md) _(testing)_
+- [Test Production Code Directly](./testing/test-production-code.md) _(testing)_
+- [Validation Patterns and Duplicate Warning Prevention](./scripting/validation-patterns.md) _(scripting)_
+
+### 🟠 Advanced
+
+- [Cache Eviction Implementation](./performance/cache-eviction-implementation.md) _(performance)_
+- [High-Performance Cache with Eviction Policies](./performance/cache-eviction-policies.md) _(performance)_
+- [Shared Fixtures: Generic Base](./testing/shared-test-fixtures-generic-base.md) _(testing)_
+- [Shared Fixtures: Reference Counting](./testing/shared-test-fixtures-reference-counting.md) _(testing)_
+- [Shared Test Fixtures with Reference Counting](./testing/shared-test-fixtures.md) _(testing)_
+
+### 🔴 Expert
+
+- [Test Invalid Skill](./testing/test-invalid-skill.md) _(testing)_
+
+---
+
+_Generated by `scripts/generate-skills-index.js`_