trunk-troubleshoot

Diagnose trunk migration issues by pattern-matching known problem categories.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/onesmartguy/raptor-claude-plugins --skill trunk-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trunk-troubleshoot
Source: https://github.com/onesmartguy/raptor-claude-plugins/tree/main/plugins/dotnet/skills/trunk-troubleshoot
Command: npx skills add https://github.com/onesmartguy/raptor-claude-plugins --skill trunk-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers quickly identify and resolve trunk-based migration issues by pattern-matching known failure modes and proposing automated fixes.

Core Features & Use Cases

  • Pattern-based diagnosis: Detects common trunk migration problems such as kustomize resource mismatches and pipeline gating issues.
  • Automated fix proposals: Suggests concrete changes and steps to resolve issues with minimal manual intervention.
  • Guided remediation flow: Presents fixes for review with traceable rationale and expected outcomes for deployments.

Quick Start

Describe your trunk migration issue and ask for diagnostics and a recommended fix.

Frequently Asked Questions about trunk-troubleshoot

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

FAQPage Schema
How do I diagnose kustomize resource mismatches during a trunk-based migration?

To diagnose kustomize resource mismatches during a trunk-based migration, describe your issue to pattern-match against 13 known failure categories. The skill identifies the specific kustomize deployment conflict and proposes an automated fix for review.

Why does my CI/CD pipeline fail gating checks when migrating to a trunk-based workflow?

Pipeline gating failures during a trunk migration occur due to recognized pipeline configuration conflicts. This diagnostic skill pattern-matches your CI/CD pipeline errors against known issues and proposes concrete configuration changes to resolve the gating blocks.

Can I automate fixes for .NET trunk migration errors without manual intervention?

You can automate fixes for .NET trunk migration errors by utilizing the guided remediation flow. The skill suggests concrete changes to resolve issues but requires your explicit approval before applying any automated fixes to ensure safe deployments.

What is the best way to troubleshoot deployment issues across kustomize-based pipelines?

The best way to troubleshoot kustomize-based pipeline deployment issues is using pattern-based diagnosis. It detects common trunk migration problems, references a troubleshooting guide, and presents fixes with traceable rationale and expected outcomes.

Does this troubleshooting approach work for both .NET migrations and kustomize deployments?

Yes, this troubleshooting approach works for .NET trunk migrations, kustomize-based deployments, and CI/CD pipelines. It pattern-matches 13 issue categories across these environments to identify failure modes and suggest targeted automated fixes.