trunk-troubleshoot

Diagnoses and fixes trunk-based migration issues by pattern-matching against 13 known failure modes.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Trigent-Software-Pvt-Ltd/trigen-aidlc --skill trunk-troubleshoot-trigent-software-pvt-ltd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trunk-troubleshoot
Source: https://github.com/Trigent-Software-Pvt-Ltd/trigen-aidlc/tree/main/plugins/dotnet/skills/trunk-troubleshoot
Command: npx skills add https://github.com/Trigent-Software-Pvt-Ltd/trigen-aidlc --skill trunk-troubleshoot-trigent-software-pvt-ltd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Trunk-based migrations of .NET services often fail with cryptic errors in Kustomize builds, GitLab CI pipelines, APIM configuration, or Auth0 setup, and engineers waste hours hunting down root causes that have been seen before. ## Core Features & Use Cases - Pattern-Based Diagnosis: Matches an error message or symptom against 13 known issue patterns covering Kustomize builds, health check ports, IngressRoute, APIM duplicates, review app variables, Auth0 secrets, NuGet jobs, production gates, flaky tests, matrix collisions, and connection strings. - Guided Fixes with Approval: Confirms the root cause by reading relevant files, explains the problem, proposes the fix, and asks for approval before changing anything. - Post-Fix Validation: Re-runs kustomize builds and YAML syntax checks after applying fixes, and falls back to general diagnostics for unknown issues. - Use Case: A pipeline fails with "readiness probe connection refused on port 80" after migration. Invoke the skill with the error text; it identifies the wrong health check port, applies the fix, and verifies the kustomize build passes. ## Quick Start Ask the assistant to troubleshoot a trunk migration issue by pasting the pipeline error message or describing the symptom you are seeing.

Frequently Asked Questions about trunk-troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a Kustomize build error after trunk migration?

Kustomize build failures usually mean a resource file referenced in kustomization.yaml is missing. The skill pattern-matches the error, confirms the missing file, applies the fix from the troubleshooting guide, and re-runs kustomize build to verify.

How to diagnose a failed GitLab CI pipeline after migrating to trunk-based development?

Provide the error message or symptom as input. The skill matches it against 13 known patterns covering NuGet jobs on MRs, production gate bypasses, matrix variable collisions, and flaky tests, then proposes and applies a validated fix.

Why does my readiness probe fail with connection refused on port 80?

This is a known pattern where health checks point to the wrong port after migration. The skill reads the relevant manifests to confirm the misconfiguration, explains the root cause, and corrects the probe port with your approval.

What happens if my migration issue is not in the known patterns list?

The skill runs general diagnostics: kustomize builds for all region and environment combinations, YAML syntax validation of .gitlab-ci.yml, checks for missing files and duplicate resources, and can suggest running a full validation pass.

Does the skill modify files without asking?

No. Every fix requires explicit user approval before changes are applied. After approval, the fix is applied and re-validated with kustomize build or YAML parsing to confirm the issue is resolved.