Commit 0faf5662ef3e

@@ -9,7 +9,20 @@ Visual content generation skill for creating diagrams, flowcharts, and technical
 
 ## Purpose
 
-This skill helps create visual content when text alone isn't sufficient. It's particularly useful for:
+This skill helps create visual content when text alone isn't sufficient.
+
+### Context Detection
+
+**This skill activates when:**
+- User asks for a diagram, flowchart, or visualization
+- User mentions creating visual representations of concepts
+- User wants to illustrate architecture, processes, or relationships
+- User asks for Mermaid diagrams, ASCII art, or graphical explanations
+- User explicitly says "show me a diagram" or "draw a flowchart"
+
+## Use Cases
+
+It's particularly useful for:
 - Technical diagrams and architecture visualizations
 - Flowcharts and process diagrams
 - Concept maps and taxonomies

@@ -9,6 +9,15 @@ description: Personal AI Infrastructure core principles and operating system. AU
 
 This skill defines the core operating principles and behaviors for personal AI assistance. It auto-loads at session start and establishes foundational patterns.
 
+### Context Detection
+
+**This skill activates when:**
+- AUTO-LOADS at every session start
+- User asks about identity, personality, or core principles
+- User asks "who are you?" or "what are your capabilities?"
+- User wants to understand response patterns or preferences
+- User asks about the PAI/PKAI system or infrastructure
+
 ## Identity and Personality
 
 **PAI's Identity:**

@@ -7,6 +7,15 @@ description: Skill creation framework for creating, validating, updating, or can
 
 Systematic skill creation framework for building consistent, well-structured Claude Code skills.
 
+### Context Detection
+
+**This skill activates when:**
+- User wants to create a new skill
+- User asks to validate, update, or fix an existing skill
+- User mentions skill structure, compliance, or canonicalization
+- User is working in `/home/vincent/.claude/skills/` directory
+- User asks about skill creation best practices or framework
+
 ## TitleCase Naming Convention
 
 **All naming must use TitleCase (PascalCase).**

@@ -8,6 +8,15 @@ description: Git version control best practices and workflows. USE WHEN working
 ## Purpose
 Guide git usage following best practices, conventional commits, and project-specific workflows.
 
+### Context Detection
+
+**This skill activates when:**
+- Current directory is a git repository (contains `.git/`) or in a git repository
+- User asks about git commands, commits, branches, or version control
+- User mentions workflows like rebasing, merging, cherry-picking
+- Commands like `git commit`, `git rebase`, `git merge` are mentioned
+- User asks about commit messages or git best practices
+
 ## Workflow Routing
 
 When the user's request matches specific Git operations, route to the appropriate workflow:

@@ -368,6 +368,7 @@ test-clean:
 8. **Run tests before committing**: `go test ./...` should pass
 9. **Use -race regularly**: Catch concurrency issues early
 10. **Keep tests fast**: Use `-short` for quick feedback
+11. **Don't test package main files**: Do not create tests for files with `package main` (typically `main.go` in either `cmd/` directories or the root directory) unless explicitly requested by the user. These files usually contain minimal logic like flag parsing, initialization, and calling application logic. Test the underlying packages instead, or use integration tests for end-to-end behavior.
 
 ## Common Issues
 

@@ -8,6 +8,12 @@ description: Go development best practices and patterns. USE WHEN writing Go cod
 ## Purpose
 Guide Go development following official standards, community best practices, and idiomatic patterns from Effective Go and the Go team's code review guidelines.
 
+### Context Detection
+
+**This skill actives when:**
+- Claude is asked to work on Go code
+- Current directory path or current git repository contains go.mod
+
 ## Workflow Routing
 
 **When executing a workflow, output this notification directly:**

@@ -8,6 +8,15 @@ description: NixOS homelab infrastructure management for the home repository. US
 ## Purpose
 Expert assistance managing personal NixOS infrastructure in the home repository.
 
+### Context Detection
+
+**This skill activates when:**
+- Current working directory is `/home/vincent/src/home` or subdirectories
+- User asks about specific hosts (kyushu, aomi, demeter, rhea, athena, etc.)
+- User mentions home repository infrastructure, services, or configurations
+- Files in `/systems`, `/home/common`, or `/modules` directories are referenced
+- User asks about DNS management, VPN, or homelab services
+
 ## Repository Structure
 - **Repository location**: ~/src/home
 - **System configs**: /systems/<hostname>/

@@ -7,6 +7,15 @@ description: Kubernetes development and operations best practices. USE WHEN work
 
 Expert guidance on Kubernetes operations, kubectl command-line usage, and cloud-native development best practices.
 
+### Context Detection
+
+**This skill activates when:**
+- Current directory contains Kubernetes manifests (`.yaml` or `.yml` files with `kind:`, `apiVersion:`)
+- User asks about kubectl commands or Kubernetes resources
+- User mentions pods, deployments, services, namespaces, or other K8s concepts
+- Commands like `kubectl`, `helm`, or `k9s` are mentioned
+- User is troubleshooting Kubernetes issues or debugging pods
+
 ## Workflow Routing
 
 **When executing a workflow, output this notification directly:**

@@ -8,6 +8,15 @@ description: Expert guidance on Nix, NixOS, and home-manager best practices. USE
 ## Purpose
 Expert guidance on Nix, NixOS, and home-manager following best practices.
 
+### Context Detection
+
+**This skill activates when:**
+- Current directory contains `flake.nix`, `default.nix`, `shell.nix`, or `configuration.nix`
+- Git repository contains Nix configuration files
+- User is working with `.nix` files
+- User explicitly mentions NixOS, home-manager, flakes, or Nix packages
+- Commands like `nix build`, `nixos-rebuild`, or `home-manager` are mentioned
+
 ## Workflow Routing
 
 When the user's request matches specific Nix operations, route to the appropriate workflow:

@@ -14,6 +14,7 @@ Expert guidance for contributing to the NixOS/nixpkgs repository, reviewing pull
 - Git remote URL contains `NixOS/nixpkgs` or `nixos/nixpkgs`
 - Current directory path contains `github.com/NixOS/nixpkgs` or `~/src/nixpkgs`
 - User explicitly mentions nixpkgs-review, nix-update, or nixpkgs contribution
+- User asks a question about nix packages
 
 ## Workflow Routing
 

@@ -8,6 +8,15 @@ description: Note-taking workflow using denote format and org-mode. USE WHEN use
 ## Purpose
 Assist with creating and organizing notes in denote format using org-mode.
 
+### Context Detection
+
+**This skill activates when:**
+- User asks to create a note, write a note, or document something
+- User mentions denote, org-mode, or note-taking
+- Working directory is `/home/vincent/desktop/org/notes`
+- User references `.org` files with denote naming pattern
+- User asks about organizing knowledge or documentation
+
 ## Note Location
 **Notes directory**: `/home/vincent/desktop/org/notes`
 

@@ -7,6 +7,15 @@ description: Tekton Pipelines CI/CD best practices for Kubernetes-native workflo
 
 Expert guidance on Tekton Pipelines, a Kubernetes-native CI/CD framework for building, testing, and deploying applications with declarative, reusable workflows.
 
+### Context Detection
+
+**This skill activates when:**
+- Current directory contains Tekton YAML files (Task, Pipeline, PipelineRun, etc.)
+- User asks about Tekton tasks, pipelines, or triggers
+- User mentions `tkn` CLI commands
+- Files contain `tekton.dev/v1` or `triggers.tekton.dev` API versions
+- User is troubleshooting pipeline runs or debugging CI/CD workflows
+
 ## Workflow Routing
 
 **When executing a workflow, output this notification directly:**