homelab-onboarding

Generate Kubernetes manifests, ArgoCD Applications, HTTPRoutes, ExternalSecrets, and Crossplane AppDB provisions.

Updated Aug 26, 2025
One-click install
npx skills add https://github.com/timosur/homelab --skill homelab-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homelab-onboarding
Source: https://github.com/timosur/homelab/tree/main/.github/skills/homelab-onboarding
Command: npx skills add https://github.com/timosur/homelab --skill homelab-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

End-to-end onboarding of new applications into the homelab Kubernetes cluster by generating all manifests, ArgoCD Applications, HTTPRoutes, ExternalSecrets, and Crossplane AppDB provisions in a single pass.

Core Features & Use Cases

  • End-to-end onboarding of new apps into the homelab, following the App of Apps pattern where apps/root.yaml points to apps/_argocd/ and creates ArgoCD Applications for each app.
  • Generates Kubernetes resources (Namespaces, Deployments, Services, ConfigMaps, Secrets), HTTPRoutes, and Crossplane AppDBClaim for centralized Postgres provisioning; optionally scaffolds app repositories with Dockerfiles and GitHub Actions CI/CD.
  • Works for onboarding new projects, deploying services, or scaffolding project templates within the homelab GitOps workflow.

Quick Start

Provide the app requirements, and have the system generate all Kubernetes, ArgoCD, and repository scaffolding in one pass.

Frequently Asked Questions about homelab-onboarding

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

FAQPage Schema
How do I onboard a new application to a Kubernetes cluster using GitOps and ArgoCD?

Onboarding new applications to a Kubernetes cluster via GitOps involves generating all manifests, ArgoCD Applications, HTTPRoutes, and ExternalSecrets in a single pass. This process follows the App of Apps pattern where apps/root.yaml points to apps/_argocd/ to create ArgoCD Applications for each app.

How does Crossplane AppDB provision PostgreSQL for new homelab deployments?

Crossplane AppDB provisions PostgreSQL for new homelab deployments by generating a Crossplane AppDBClaim during the onboarding pass. This provides centralized Postgres provisioning alongside standard Kubernetes resources like namespaces, deployments, and services without manual database setup.

Can I scaffold repository templates with Dockerfiles and GitHub Actions for homelab services?

You can scaffold repository templates with Dockerfiles and GitHub Actions CI/CD for homelab services during the onboarding process. The system optionally generates this repository scaffolding alongside Kubernetes manifests, ArgoCD Applications, and HTTPRoutes in one pass.

What Kubernetes resources are generated when deploying services with the App of Apps pattern?

Deploying services with the App of Apps pattern generates namespaces, deployments, services, configmaps, secrets via ExternalSecret, appdb, and PVCs. It also creates ArgoCD Applications and HTTPRoutes to ensure complete routing and GitOps synchronization within the homelab cluster.

Does the homelab onboarding process support centralized CNPG provisioning for new projects?

The homelab onboarding process supports centralized CNPG provisioning by generating Crossplane AppDBClaims for new projects. This aligns with the GitOps workflow to automate Postgres database creation directly alongside application manifests and routing configurations.

Why use a single pass to generate ArgoCD Applications and HTTPRoutes for homelab projects?

Using a single pass to generate ArgoCD Applications and HTTPRoutes for homelab projects ensures end-to-end GitOps consistency and eliminates manual manifest stitching. It creates all required namespaces, routing, and centralized database provisions simultaneously to streamline deployments.