kargo-skill

Automate artifact promotions across environments using Freight, Warehouses, and ArgoCD.

7|1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill kargo-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kargo-skill
Source: https://github.com/julianobarbosa/claude-code-skills/tree/main/skills/kargo-skill
Command: npx skills add https://github.com/julianobarbosa/claude-code-skills --skill kargo-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Kargo provides a comprehensive guide to progressive delivery and GitOps-based promotion workflows, enabling safe, automated promotions across environments.

Core Features & Use Cases

  • Progressive Delivery: Stage-and-promote pipelines with warehouses and stages.
  • ArgoCD Integration: Promote changes via ArgoCD integration patterns.
  • Freight & Promotion: Manage Freight artifacts and promotions across environments.
  • Use Case: Automatically promote a service after tests pass in staging.

Quick Start

Deploy a warehouse and a stage with automated promotion steps.

Frequently Asked Questions about kargo-skill

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

FAQPage Schema
How do I automate artifact promotions across environments using GitOps?

Artifact promotions in GitOps pipelines use Kargo's Freight and Warehouse system to automatically move images, charts, and configurations across staging, canary, and production stages. Define warehouses to track artifacts, create stages with promotion templates, and configure verification steps to ensure safe, auditable promotions driven by ArgoCD.

Can I integrate Kargo promotions with ArgoCD?

Yes. Kargo integrates directly with ArgoCD to trigger and manage promotions across environments. Once Freight artifacts are qualified in a stage, ArgoCD applies the promoted configurations, enabling end-to-end GitOps-driven delivery without manual intervention.

What Kubernetes prerequisites do I need to set up Kargo?

Kargo requires a Kubernetes cluster with Helm support for installation. You must configure warehouse subscriptions, define freight management policies, set up promotion templates with YAML-based steps, and optionally add verification templates to validate promotions before advancing to the next stage.

How does progressive delivery work in Kargo stage-and-promote pipelines?

Progressive delivery in Kargo uses stages as gates for promotions. Freight moves through warehouses and stages in sequence—typically staging, then canary, then production. Promotion templates and verification templates automate the advancement, ensuring artifacts meet requirements before progressing to higher-risk environments.

What's the difference between using Kargo and manual promotion workflows?

Kargo replaces manual promotion steps with auditable, automated workflows. It eliminates configuration drift, provides clear promotion history via Freight tracking, integrates with ArgoCD for declarative delivery, and scales promotion logic across multiple environments without operator intervention.

When should I use Kargo for deployments instead of basic ArgoCD?

Use Kargo when you need controlled, multi-stage promotions with verification gates, audit trails, and integration of test results into promotion decisions. It's ideal for organizations running staging, canary, and production pipelines that require safe, automated progression across environments.