Add Waza skill quality CI

Author: KSemenenko

.github/workflows/catalog-check.yml

@@ -7,6 +7,8 @@ on:
 jobs:
   check:
     runs-on: ubuntu-latest
+    env:
+      WAZA_VERSION: v0.31.0
 
     steps:
       - name: Check out repository
@@ -23,8 +25,18 @@ jobs:
           curl -fsSL https://carvel.dev/install.sh | K14SIO_INSTALL_BIN_DIR="$PWD/.tools" bash
           echo "$PWD/.tools" >> "$GITHUB_PATH"
 
+      - name: Install Waza CI checker
+        run: |
+          mkdir -p .tools
+          curl -fsSL -o .tools/waza-linux-amd64 "https://github.com/microsoft/waza/releases/download/${WAZA_VERSION}/waza-linux-amd64"
+          curl -fsSL -o .tools/waza-checksums.txt "https://github.com/microsoft/waza/releases/download/${WAZA_VERSION}/checksums.txt"
+          (cd .tools && grep 'waza-linux-amd64' waza-checksums.txt | sha256sum -c --status)
+          mv .tools/waza-linux-amd64 .tools/waza
+          chmod +x .tools/waza
+          echo "$PWD/.tools" >> "$GITHUB_PATH"
+
       - name: Validate automation scripts
-        run: python3 -m py_compile scripts/generate_catalog.py scripts/generate_catalog_definitions.py scripts/generate_agent_catalog.py scripts/generate_release_notes.py scripts/import_external_catalog_sources.py scripts/upstream_watch.py
+        run: python3 -m py_compile scripts/generate_catalog.py scripts/generate_catalog_definitions.py scripts/generate_agent_catalog.py scripts/generate_release_notes.py scripts/import_external_catalog_sources.py scripts/upstream_watch.py scripts/waza_skill_quality.py
 
       - name: Run automation regression tests
         run: python3 -m unittest discover -s scripts/tests -p 'test_*.py'
@@ -43,9 +55,19 @@ jobs:
           python3 scripts/generate_catalog.py --validate-only
           python3 scripts/generate_agent_catalog.py --validate-only
 
+      - name: Run Waza skill quality report
+        run: python3 scripts/waza_skill_quality.py
+
       - name: Validate upstream watch config
         run: python3 scripts/upstream_watch.py --validate-config
 
+      - name: Upload Waza skill quality report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: waza-skill-quality
+          path: artifacts/waza-skill-quality/
+
       - name: Validate upstream watch JSON
         run: |
           python3 - <<'PY'

.waza.yaml

@@ -0,0 +1,10 @@
+tokens:
+  warningThreshold: 3500
+  fallbackLimit: 5000
+  limits:
+    defaults:
+      "catalog/**/SKILL.md": 5000
+      "catalog/**/AGENT.md": 3000
+      "catalog/**/references/**/*.md": 5000
+      "agents/**/AGENT.md": 3000
+      "*.md": 3000

AGENTS.md

@@ -74,6 +74,8 @@ Update this file when the user gives:
 
 Treat explicit frustration, swearing, sarcasm, repeated rejection, or "don't do this again" as strong signals that a durable rule should likely be captured here.
 
+- Waza is a repository CI quality-check dependency for evaluating catalog skill quality. Do not add Waza as a catalog skill, package, tool entry, install bundle, or public catalog surface.
+
 - The repo is moving away from the repo-authored `dotnet-*` skill-id namespace. Prefer clean canonical skill ids without the `dotnet-` prefix for repo-authored skills, and when renaming public skill ids, do a clean cutover instead of keeping backward-compatible legacy aliases unless the user explicitly asks for a compatibility bridge.
 
 - For interactive CLI UX changes in the publishable tools, run a dedicated Claude-led design pass before finalizing the console presentation.

README.md

@@ -1,6 +1,6 @@
 ---
 name: aspnet-core
-description: "Build, debug, modernize, or review ASP.NET Core applications with correct hosting, middleware, security, configuration, logging, and deployment patterns on current .NET."
+description: "Build, debug, modernize, or review ASP.NET Core applications with correct hosting, middleware, security, configuration, logging, and deployment patterns on current .NET. USE FOR: working on ASP.NET Core apps, services, or middleware; changing auth, routing, configuration, hosting, or deployment behavior; deciding between ASP.NET Core sub-stacks. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Requires an ASP.NET Core project or solution."
 ---
 

catalog/Frameworks/ASP.NET-Core/skills/aspnet-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: aspire
-description: "Build, upgrade, and operate .NET Aspire 13.2.x application hosts with current CLI, AppHost, ServiceDefaults, integrations, dashboard, testing, and Azure deployment patterns for distributed apps."
+description: "Build, upgrade, and operate .NET Aspire 13.2.x application hosts with current CLI, AppHost, ServiceDefaults, integrations, dashboard, testing, and Azure deployment patterns for distributed apps. USE FOR: Aspire.AppHost.Sdk, Aspire.Hosting.*, DistributedApplication.CreateBuilder, WithReference, WaitFor, AddProject, AddRedis, AddPostgres, aspire run, aspire init, aspire. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Best for current Aspire 13.2.x tooling on .NET 10; use version-aware upgrade guidance for older 8.x or 9.x Aspire solutions."
 ---
 

catalog/Frameworks/Aspire/skills/aspire/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: azure-functions
-description: "Build, review, or migrate Azure Functions in .NET with correct execution model, isolated worker setup, bindings, DI, and Durable Functions patterns."
+description: "Build, review, or migrate Azure Functions in .NET with correct execution model, isolated worker setup, bindings, DI, and Durable Functions patterns. USE FOR: working on Azure Functions in .NET; migrating from the in-process model to the isolated worker model; adding Durable Functions, bindings, or host configuration. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Requires an Azure Functions project or a migration plan for one."
 ---
 

catalog/Frameworks/Azure-Functions/skills/azure-functions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: blazor
-description: "Build and review Blazor applications across server, WebAssembly, web app, and hybrid scenarios with correct component design, state flow, rendering, and hosting choices."
+description: "Build and review Blazor applications across server, WebAssembly, web app, and hybrid scenarios with correct component design, state flow, rendering, and hosting choices. USE FOR: building interactive web UIs with C# instead of JavaScript; choosing between Server, WebAssembly, or Auto render modes; designing component hierarchies and state. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Requires Blazor project (.NET 6+, preferably .NET 8+ for unified model)."
 ---
 

catalog/Frameworks/Blazor/skills/blazor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: entity-framework6
-description: "Maintain or migrate EF6-based applications with realistic guidance on what to keep, what to modernize, and when EF Core is or is not the right next step. Use when working in an EF6 codebase or planning a data layer migration."
+description: "Maintain or migrate EF6-based applications with realistic guidance on what to keep, what to modernize, and when EF Core is or is not the right next step. USE FOR: EF6 codebases; runtime versus ORM migration decisions; EDMX, code-first, ObjectContext, and legacy data-access review. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Requires EF6 or a transition plan from EF6 to EF Core or modern .NET."
 ---
 
@@ -34,12 +34,12 @@ compatibility: "Requires EF6 or a transition plan from EF6 to EF Core or modern
    | EF6 → EF Core | Clean data layer, no EDMX, minimal stored-procedure mapping |
 
 3. **For maintenance work** — keep EF6 stable:
-   - use repository + unit of work patterns to isolate data access (see references/patterns.md)
+   - use repository + unit of work patterns to isolate data access (see [references/patterns.md](references/patterns.md))
    - prefer `DbContext` over `ObjectContext` for new code
    - use `AsNoTracking()` for read-only queries
    - configure concurrency tokens with `[ConcurrencyCheck]` or `IsRowVersion()`
 4. **For migration work** — validate each slice:
-   - map EF6 features to EF Core equivalents (see references/migration.md)
+   - map EF6 features to EF Core equivalents (see [references/migration.md](references/migration.md))
    - migrate one bounded context at a time, not the entire data layer
    - run integration tests against the real database provider, not InMemory
    - verify: `dotnet ef migrations add` succeeds, queries produce equivalent results, lazy loading behavior matches expectations
@@ -74,5 +74,5 @@ flowchart LR
 
 ## References
 
-- references/migration.md - decision framework, migration approaches, EF6-to-EF Core feature mapping, and common pitfalls
-- references/patterns.md - repository and unit of work patterns, query optimization, concurrency handling, auditing, and testing strategies for EF6 codebases
+- [references/migration.md](references/migration.md) - decision framework, migration approaches, EF6-to-EF Core feature mapping, and common pitfalls
+- [references/patterns.md](references/patterns.md) - repository and unit of work patterns, query optimization, concurrency handling, auditing, and testing strategies for EF6 codebases

catalog/Frameworks/Entity-Framework-6/skills/entity-framework6/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: entity-framework-core
-description: "Design, tune, or review EF Core data access with proper modeling, migrations, query translation, performance, and lifetime management for modern .NET applications."
+description: "Design, tune, or review EF Core data access with proper modeling, migrations, query translation, performance, and lifetime management for modern .NET applications. USE FOR: DbContext, migrations, model configuration, EF queries, tracking, loading, performance, transactions, and EF6 migration decisions. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
 compatibility: "Requires EF Core 7+ (preferably 8/9 for latest features)."
 ---