PluginBench
Skill
Fail
Audit score 45

k8s-manifest-generator

wshobson/agents

Generate production-ready Kubernetes manifests with built-in best practices and security standards.

What is k8s-manifest-generator?

Creates well-structured Kubernetes YAML manifests for Deployments, Services, ConfigMaps, Secrets, and PersistentVolumeClaims following cloud-native best practices. Use this when you need to generate K8s resources that are secure, properly configured, and ready for production environments.

  • Generate Deployment manifests with resource requests, limits, and health checks
  • Create Service resources for network connectivity and load balancing
  • Define ConfigMap and Secret resources for configuration management
  • Create PersistentVolumeClaim manifests for stateful workloads
  • Apply security contexts and non-root user configurations
  • Implement proper labeling and naming conventions for resource organization

How to install k8s-manifest-generator

npx skills add https://github.com/wshobson/agents --skill k8s-manifest-generator
Claude Code
Cursor
Windsurf
Cline

How to use k8s-manifest-generator

  1. 1.Specify the Kubernetes resource type you need (Deployment, Service, ConfigMap, Secret, or PersistentVolumeClaim)
  2. 2.Provide application details including image, ports, environment variables, and resource requirements
  3. 3.Define health checks (liveness and readiness probes) for pod management
  4. 4.Configure security context settings (non-root user, dropped capabilities)
  5. 5.Review generated manifests against the best practices checklist
  6. 6.Validate manifests using kubectl dry-run before applying to cluster
  7. 7.Store manifests in Git version control for tracking and CI/CD integration

Use cases

Good for
  • Creating new microservice deployments with proper resource constraints and health checks
  • Setting up multi-environment Kubernetes configurations with ConfigMaps and Secrets
  • Generating manifests for stateful applications requiring persistent storage
  • Implementing security best practices like non-root containers and capability dropping
  • Organizing and labeling resources for filtering and multi-tenant cluster management
Who it's for
  • DevOps engineers building Kubernetes infrastructure
  • Backend developers deploying applications to K8s clusters
  • Platform engineers standardizing manifest generation across teams
  • SREs implementing production-grade configurations

k8s-manifest-generator FAQ

What resource types can this skill generate?

Deployments, Services, ConfigMaps, Secrets, and PersistentVolumeClaims. For more complex scenarios, consider using Helm or Kustomize templating.

Does this skill set resource limits automatically?

Yes, it enforces setting resource requests and limits as a best practice to prevent resource starvation and ensure proper cluster scheduling.

How do I troubleshoot pods that won't start?

Use kubectl describe pod <pod-name> to check image pull errors, verify resource availability with kubectl get nodes, and review events with kubectl get events --sort-by='.lastTimestamp'.

Should I use specific image tags?

Yes, always use specific image tags instead of 'latest' to ensure predictable and reproducible deployments.

What should I do after generating manifests?

Store them in Git, validate with kubectl dry-run, set up a CI/CD pipeline, and consider GitOps tools like ArgoCD or Flux for automated deployments.

Full instructions (SKILL.md)

Source of truth, from wshobson/agents.


name: k8s-manifest-generator description: Create production-ready Kubernetes manifests for Deployments, Services, ConfigMaps, and Secrets following best practices and security standards. Use when generating Kubernetes YAML manifests, creating K8s resources, or implementing production-grade Kubernetes configurations.

Kubernetes Manifest Generator

Step-by-step guidance for creating production-ready Kubernetes manifests including Deployments, Services, ConfigMaps, Secrets, and PersistentVolumeClaims.

Purpose

This skill provides comprehensive guidance for generating well-structured, secure, and production-ready Kubernetes manifests following cloud-native best practices and Kubernetes conventions.

When to Use This Skill

Use this skill when you need to:

  • Create new Kubernetes Deployment manifests
  • Define Service resources for network connectivity
  • Generate ConfigMap and Secret resources for configuration management
  • Create PersistentVolumeClaim manifests for stateful workloads
  • Follow Kubernetes best practices and naming conventions
  • Implement resource limits, health checks, and security contexts
  • Design manifests for multi-environment deployments

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices Summary

  1. Always set resource requests and limits - Prevents resource starvation
  2. Implement health checks - Ensures Kubernetes can manage your application
  3. Use specific image tags - Avoid unpredictable deployments
  4. Apply security contexts - Run as non-root, drop capabilities
  5. Use ConfigMaps and Secrets - Separate config from code
  6. Label everything - Enables filtering and organization
  7. Follow naming conventions - Use standard Kubernetes labels
  8. Validate before applying - Use dry-run and validation tools
  9. Version your manifests - Keep in Git with version control
  10. Document with annotations - Add context for other developers

Troubleshooting

Pods not starting:

  • Check image pull errors: kubectl describe pod <pod-name>
  • Verify resource availability: kubectl get nodes
  • Check events: kubectl get events --sort-by='.lastTimestamp'

Service not accessible:

  • Verify selector matches pod labels: kubectl get endpoints <service-name>
  • Check service type and port configuration
  • Test from within cluster: kubectl run debug --rm -it --image=busybox -- sh

ConfigMap/Secret not loading:

  • Verify names match in Deployment
  • Check namespace
  • Ensure resources exist: kubectl get configmap,secret

Next Steps

After creating manifests:

  1. Store in Git repository
  2. Set up CI/CD pipeline for deployment
  3. Consider using Helm or Kustomize for templating
  4. Implement GitOps with ArgoCD or Flux
  5. Add monitoring and observability

Related Skills

  • helm-chart-scaffolding - For templating and packaging
  • gitops-workflow - For automated deployments
  • k8s-security-policies - For advanced security configurations