fix: Correct YAML frontmatter name format to category-filename kebab-case

rand · rand · commit c6531b17557f · 2025-10-26T06:58:26.000-06:00
Fix YAML frontmatter in 26 skills to use correct category-filename format
instead of human-readable titles, resolving CI/CD smoke test failures.

Fixed skills:
- 5 ML evaluation skills (llm-as-judge, llm-benchmarks-evaluation, llm-evaluation-frameworks, rag-evaluation-metrics, custom-llm-evaluation)
- 8 build systems skills (make-fundamentals, cmake-patterns, ninja-build-system, meson-build-system, bazel-build-system, autotools-fundamentals, build-system-selection, cross-compilation)
- 13 debugging skills (gdb-fundamentals, lldb-macos-debugging, pdb-python-debugging, delve-go-debugging, debugger-selection, logging-best-practices, distributed-systems-debugging, performance-profiling, memory-debugging, container-debugging, network-debugging, concurrency-debugging, core-dump-analysis)

Pattern applied: name: category-filename (e.g., ml-llm-as-judge)
diff --git a/skills/build-systems/bazel-monorepos.md b/skills/build-systems/bazel-monorepos.md
@@ -1,5 +1,5 @@
 ---
-name: Bazel Monorepos
+name: build-systems-bazel-monorepos
 description: Bazel BUILD files, WORKSPACE/MODULE.bazel, hermetic builds, remote caching, build rules, Starlark custom rules, and monorepo best practices for polyglot projects.
 ---
 # Bazel Monorepos
diff --git a/skills/build-systems/build-optimization.md b/skills/build-systems/build-optimization.md
@@ -1,5 +1,5 @@
 ---
-name: Build Optimization
+name: build-systems-build-optimization
 description: Incremental builds, dependency tracking, build caching (ccache, sccache, Bazel), parallel builds, build time profiling, and CI/CD optimization strategies.
 ---
 # Build Optimization
diff --git a/skills/build-systems/build-system-selection.md b/skills/build-systems/build-system-selection.md
@@ -1,5 +1,5 @@
 ---
-name: Build System Selection
+name: build-systems-build-system-selection
 description: Decision matrix for choosing between Make, CMake, Gradle, Maven, Bazel, and other build systems based on project requirements, language, and scale.
 ---
 # Build System Selection
diff --git a/skills/build-systems/cmake-patterns.md b/skills/build-systems/cmake-patterns.md
@@ -1,5 +1,5 @@
 ---
-name: CMake Patterns
+name: build-systems-cmake-patterns
 description: Modern CMake target-based approach, find_package, FetchContent, generator expressions, cross-platform configuration, and installation rules for C/C++ projects.
 ---
 # CMake Patterns
diff --git a/skills/build-systems/cross-platform-builds.md b/skills/build-systems/cross-platform-builds.md
@@ -1,5 +1,5 @@
 ---
-name: Cross-Platform Builds
+name: build-systems-cross-platform-builds
 description: Platform detection, conditional compilation, preprocessor macros, CMake cross-compilation, Zig cross-compilation, toolchain configuration, and multi-platform testing strategies.
 ---
 # Cross-Platform Builds
diff --git a/skills/build-systems/gradle-jvm-builds.md b/skills/build-systems/gradle-jvm-builds.md
@@ -1,5 +1,5 @@
 ---
-name: Gradle JVM Builds
+name: build-systems-gradle-jvm-builds
 description: Gradle Kotlin DSL and Groovy DSL, dependency management, version catalogs, build lifecycle, task configuration, multi-project builds, and performance optimization for Java/Kotlin projects.
 ---
 # Gradle JVM Builds
diff --git a/skills/build-systems/make-fundamentals.md b/skills/build-systems/make-fundamentals.md
@@ -1,5 +1,5 @@
 ---
-name: Make Fundamentals
+name: build-systems-make-fundamentals
 description: Makefile syntax, targets, dependencies, pattern rules, and best practices for building C/C++ and multi-language projects with Make.
 ---
 # Make Fundamentals
diff --git a/skills/build-systems/maven-configuration.md b/skills/build-systems/maven-configuration.md
@@ -1,5 +1,5 @@
 ---
-name: Maven Configuration
+name: build-systems-maven-configuration
 description: Maven POM structure, dependency management, plugin configuration, lifecycle phases, multi-module projects, profiles, and repository management for Java projects.
 ---
 # Maven Configuration
diff --git a/skills/debugging/browser-devtools.md b/skills/debugging/browser-devtools.md
@@ -1,5 +1,5 @@
 ---
-name: Browser DevTools
+name: debugging-browser-devtools
 description: Comprehensive guide to browser developer tools for debugging web applications. Covers Chrome/Firefox/Safari DevTools including Sources panel, breakpoints, performance profiling, memory analysis, network debugging, Console API, React/Vue debugging, and Lighthouse/Core Web Vitals.
 ---
 
diff --git a/skills/debugging/concurrency-debugging.md b/skills/debugging/concurrency-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: concurrency-debugging
+name: debugging-concurrency-debugging
 description: Race condition detection, deadlock debugging, and data race analysis using ThreadSanitizer and specialized tools
 ---
 
diff --git a/skills/debugging/container-debugging.md b/skills/debugging/container-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: debugging-containers
+name: debugging-container-debugging
 description: Debugging applications inside containers using docker exec, kubectl debug, ephemeral containers, and distroless debugging techniques
 ---
 
diff --git a/skills/debugging/core-dump-analysis.md b/skills/debugging/core-dump-analysis.md
@@ -1,5 +1,5 @@
 ---
-name: core-dump-analysis
+name: debugging-core-dump-analysis
 description: Core dump generation, GDB/LLDB analysis, crash reporting, and post-mortem debugging across platforms
 ---
 
diff --git a/skills/debugging/crash-debugging.md b/skills/debugging/crash-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: crash-debugging
+name: debugging-crash-debugging
 description: Signal handling, crash reproduction, fuzzing for crash discovery, telemetry aggregation, and post-mortem workflows
 ---
 
diff --git a/skills/debugging/distributed-systems-debugging.md b/skills/debugging/distributed-systems-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: debugging-distributed-systems
+name: debugging-distributed-systems-debugging
 description: Debugging distributed systems with trace correlation, cross-service workflows, request replay, clock skew handling, and chaos engineering
 ---
 
diff --git a/skills/debugging/gdb-fundamentals.md b/skills/debugging/gdb-fundamentals.md
@@ -1,5 +1,5 @@
 ---
-name: GDB Fundamentals
+name: debugging-gdb-fundamentals
 description: Comprehensive guide to GNU Debugger (GDB) for debugging C/C++/Rust programs. Covers breakpoints, stack traces, variable inspection, TUI mode, .gdbinit customization, Python scripting, remote debugging, and core file analysis.
 ---
 
diff --git a/skills/debugging/lldb-macos-debugging.md b/skills/debugging/lldb-macos-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: LLDB macOS Debugging
+name: debugging-lldb-macos-debugging
 description: Comprehensive guide to LLDB debugger for macOS/iOS development. Covers LLDB vs GDB differences, Swift/Objective-C debugging, Xcode integration, command-line usage, breakpoint expressions, watchpoints, Python scripting, and performance improvements (50x faster step-over in 2025).
 ---
 
diff --git a/skills/debugging/memory-leak-debugging.md b/skills/debugging/memory-leak-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: memory-leak-debugging
+name: debugging-memory-leak-debugging
 description: Comprehensive memory leak detection and debugging using heap profiling tools across multiple languages
 ---
 
diff --git a/skills/debugging/network-debugging.md b/skills/debugging/network-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: debugging-network
+name: debugging-network-debugging
 description: Network debugging with tcpdump, Wireshark, curl, DNS tools, SSL/TLS inspection, and network tracing utilities
 ---
 
diff --git a/skills/debugging/production-debugging.md b/skills/debugging/production-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: debugging-production
+name: debugging-production-debugging
 description: Non-intrusive debugging in production environments with feature flags, dynamic logging, and observability correlation
 ---
 
diff --git a/skills/debugging/python-debugging.md b/skills/debugging/python-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: Python Debugging
+name: debugging-python-debugging
 description: Comprehensive guide to Python debugging tools and techniques. Covers pdb (built-in debugger), ipdb (IPython integration), VSCode debugger, PyCharm debugger, pytest debugging, remote debugging with debugpy, and performance profiling with cProfile.
 ---
 
diff --git a/skills/debugging/remote-debugging.md b/skills/debugging/remote-debugging.md
@@ -1,5 +1,5 @@
 ---
-name: Remote Debugging
+name: debugging-remote-debugging
 description: Comprehensive guide to remote debugging techniques for production and development environments. Covers SSH port forwarding, VSCode Remote Development, JetBrains Gateway, container debugging (Docker), Kubernetes debugging, production-safe debugging, debug symbols, and source maps.
 ---
 
diff --git a/skills/ml/custom-llm-evaluation.md b/skills/ml/custom-llm-evaluation.md
@@ -1,5 +1,5 @@
 ---
-name: Custom LLM Evaluation
+name: ml-custom-llm-evaluation
 description: Domain-specific LLM evaluation including custom metrics, RLHF evaluation, adversarial testing, bias detection, Arize Phoenix integration, and continuous evaluation patterns for production systems
 ---
 
diff --git a/skills/ml/llm-as-judge.md b/skills/ml/llm-as-judge.md
@@ -1,5 +1,5 @@
 ---
-name: LLM-as-Judge Evaluation
+name: ml-llm-as-judge
 description: Comprehensive guide to LLM-as-judge evaluation patterns including Prometheus 2 models, G-Eval framework, pairwise/pointwise/reference-guided methods, bias mitigation, and uncertainty quantification
 ---
 
diff --git a/skills/ml/llm-benchmarks-evaluation.md b/skills/ml/llm-benchmarks-evaluation.md
@@ -1,5 +1,5 @@
 ---
-name: LLM Benchmarks Evaluation
+name: ml-llm-benchmarks-evaluation
 description: Comprehensive guide to evaluating LLMs using standard benchmarks including MMLU, HellaSwag, BBH, HumanEval, TruthfulQA, and GSM8K, with practical implementation using LightEval and lm-evaluation-harness
 ---
 
diff --git a/skills/ml/llm-evaluation-frameworks.md b/skills/ml/llm-evaluation-frameworks.md
@@ -1,5 +1,5 @@
 ---
-name: LLM Evaluation Frameworks
+name: ml-llm-evaluation-frameworks
 description: Production-grade LLM evaluation using Arize Phoenix (OpenTelemetry tracing, self-hosted evals), Braintrust (86x faster search), LangSmith, and Langfuse with cost tracking and observability integration
 ---
 
diff --git a/skills/ml/rag-evaluation-metrics.md b/skills/ml/rag-evaluation-metrics.md
@@ -1,5 +1,5 @@
 ---
-name: RAG Evaluation Metrics
+name: ml-rag-evaluation-metrics
 description: Comprehensive guide to RAG evaluation using RAGAS (Faithfulness, Answer Relevancy, Context Precision/Recall), LLM-as-judge patterns, synthetic datasets, and integration with Arize Phoenix and Langfuse
 ---
 
