Claude Code Plugins

Community-maintained marketplace

Feedback

Deploy AI agents to Kubernetes cluster. Use when deploying, updating, or checking agent versions. Handles GitOps workflow with Flux CD or immediate kubectl deploys.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name deploy
description Deploy AI agents to Kubernetes cluster. Use when deploying, updating, or checking agent versions. Handles GitOps workflow with Flux CD or immediate kubectl deploys.

Deploy Agent

Deploy or update an AI agent to a specific version via GitOps (recommended) or kubectl (immediate).

Arguments

  • agent-name: k8s-monitor, news-monitor (required)
  • version: Image tag to deploy (optional, shows current if omitted)
  • --immediate: Use kubectl instead of GitOps (bypasses Flux)

Instructions

Show Current Version

cd /home/al/git/kubani
grep "image: registry.almckay.io/${AGENT_NAME}:" gitops/apps/ai-agents/${AGENT_NAME}/deployment.yaml | head -1

GitOps Deploy (Default - Recommended)

  1. Update the GitOps manifest:

    cd /home/al/git/kubani
    sed -i "s|registry.almckay.io/${AGENT_NAME}:[^ ]*|registry.almckay.io/${AGENT_NAME}:${VERSION}|g" \
      gitops/apps/ai-agents/${AGENT_NAME}/deployment.yaml
    
  2. Commit and push:

    git add gitops/apps/ai-agents/${AGENT_NAME}/deployment.yaml
    git commit -m "chore(gitops): deploy ${AGENT_NAME}:${VERSION}"
    git push
    
  3. Monitor the rollout:

    KUBECONFIG=/home/al/.kube/config kubectl rollout status deployment/${AGENT_NAME} -n ai-agents --timeout=120s
    

Immediate Deploy (--immediate flag)

Use kubectl directly for faster deployment (bypasses GitOps):

KUBECONFIG=/home/al/.kube/config kubectl set image deployment/${AGENT_NAME} \
  --all \
  -n ai-agents \
  "*=registry.almckay.io/${AGENT_NAME}:${VERSION}"

Note: Immediate deploys will be overwritten when Flux next syncs.

Finding Available Versions

# Check git history for previous tags
git log --oneline -10 gitops/apps/ai-agents/${AGENT_NAME}/deployment.yaml

# List recent image tags from registry
docker images | grep ${AGENT_NAME}

Version Format

  • 0.1.0-abc1234 - Standard format: pyproject.toml version + git SHA
  • latest - Most recent build (not recommended for production)
  • 0.1.0 - Semantic version from tagged release