Skip to content

feat: add carto-sh-support-bundle skill#48

Closed
fergordo wants to merge 1 commit into
masterfrom
feat/carto-sh-support-bundle
Closed

feat: add carto-sh-support-bundle skill#48
fergordo wants to merge 1 commit into
masterfrom
feat/carto-sh-support-bundle

Conversation

@fergordo

Copy link
Copy Markdown

Summary

  • Adds carto-sh-support-bundle, a new utility skill for analysing CARTO Self-Hosted support bundles
  • Structured as an 8-step triage workflow (debug mode → timestamp → app status → requirement validators → deployments → pods → events → logs)
  • Splits deep content into two reference files to keep SKILL.md under the 5KB target

What's included

SKILL.md — the main skill with When to Use, Steps, Output Format, and Guardrails sections

references/bundle-structure.md — full directory map for both standard KOTS (GKE/AKS/EKS) and embedded-cluster (single-node AWS) installs, including key file/field reference table

references/known-patterns.md — documented failure patterns:

  • Ingress Testing Mode (root cause from issue #9917, STC/Masterworks)
  • Duplicate license / `InvalidSelfHostedInstanceId`
  • `initial-app-images-pushed: false` escalation trigger
  • SA-related failures
  • Known noise (LaunchDarkly, Redis transient, router syslog, maps-api EventEmitter)
  • What a healthy bundle looks like

Test plan

  • `make validate` passes (24 skills OK, 521 snippets OK)
  • `make sync` regenerated all manifests cleanly
  • Smoke test: load the skill in Claude Code and point it at a real bundle directory

🤖 Generated with Claude Code

New utility skill for analysing CARTO Self-Hosted support bundles.
Covers the full triage workflow — debug mode check, KOTS app status,
requirement validators, deployment/pod state, and pod logs — with
reference files documenting known failure patterns (Ingress Testing Mode,
duplicate license, initial-app-images-pushed, SA failures) and bundle
structure differences between standard KOTS and embedded-cluster installs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@fergordo
fergordo requested a review from moicalcob June 15, 2026 09:39
@srtena

srtena commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Wrong repo @fergordo @alroba. Please check your processes. Closing ❌

@srtena srtena closed this Jun 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants