add-service

Generate ArgoCD, Kustomize, and Helm scaffolding for new homelab services.

5|Updated Aug 26, 2024
One-click install
npx skills add https://github.com/jomcgi/homelab --skill add-service-jomcgi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-service
Source: https://github.com/jomcgi/homelab/tree/main/.claude/skills/add-service
Command: npx skills add https://github.com/jomcgi/homelab --skill add-service-jomcgi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill scaffolds the GitOps boilerplate for deploying a new service via ArgoCD in the homelab repository, saving time and reducing errors.

Core Features & Use Cases

  • Creates boilerplate for overlays/{env}/{service}/ including application.yaml, kustomization.yaml, and values.yaml.
  • Provides environment-scoped scaffolding and ready-to-customize placeholders for deployment to prod, dev, or cluster-critical.
  • Improves consistency across services by standardizing ArgoCD, Helm, and Kustomize integration.

Quick Start

Run the command /add-service <service-name> <environment> to generate overlays/{env}/{service}/ with application.yaml, kustomization.yaml, and values.yaml.

Frequently Asked Questions about add-service

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

FAQPage Schema
How do I scaffold GitOps boilerplate for a new service using ArgoCD and Kustomize?

To scaffold GitOps boilerplate for a new service, you generate standardized overlays containing application.yaml, kustomization.yaml, and values.yaml. This creates a structured directory with environment-specific overrides and ready-to-customize placeholders for ArgoCD deployment.

What's the best way to generate environment-specific Kustomize overlays for prod and dev?

The best way to generate environment-specific Kustomize overlays is to use a scaffolding command that targets your desired environment, automatically producing distinct prod, dev, or cluster-critical directories with appropriate Helm value overrides and ArgoCD application definitions.

Does this GitOps scaffolding support Helm values alongside Kustomize?

Yes, this GitOps scaffolding supports Helm values alongside Kustomize by generating a values.yaml file within the service overlay. It standardizes the integration of ArgoCD, Helm, and Kustomize to ensure consistent configuration across all deployed environments.

Can I use this to create ArgoCD application manifests for multiple environments?

Yes, you can use this to create ArgoCD application manifests for multiple environments. It generates an application.yaml file within each environment's overlay directory, providing environment-scoped scaffolding for prod, dev, and cluster-critical deployments.

When do I need to generate Kustomize overlays for homelab infrastructure-as-code?

You need to generate Kustomize overlays for homelab infrastructure-as-code when adding a new service to your GitOps repository, ensuring standardized boilerplate creation and reducing manual configuration errors across your deployment environments.

Why does manually creating ArgoCD and Kustomize boilerplate lead to inconsistencies?

Manually creating ArgoCD and Kustomize boilerplate leads to inconsistencies because it lacks standardized templating across environments. Automating the scaffolding of application.yaml, kustomization.yaml, and values.yaml ensures uniform structure and reduces deployment configuration errors.