eg-contrib-add-api

Update Envoy Gateway CRD Go types, validations, and code-generation scaffolding.

3|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/missBerg/envoy-skills --skill eg-contrib-add-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eg-contrib-add-api
Source: https://github.com/missBerg/envoy-skills/tree/main/gateway/contributors/skills/eg-contrib-add-api
Command: npx skills add https://github.com/missBerg/envoy-skills --skill eg-contrib-add-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides contributors in adding or extending Envoy Gateway CRD APIs by updating Go types, validation markers, and code-generation scaffolding to maintain API consistency and governance.

Core Features & Use Cases

  • Structured API changes: Define or modify CRD types, fields, and validations in api/v1alpha1 with clear guidelines.
  • Code-generation readiness: Ensure make generate and controller-gen workflows are prepared for PR-driven changes.
  • API governance and collaboration: Align with API design rules and PR governance to avoid regressions in CRD behavior.

Quick Start

Create or modify a CRD API by updating the Go types, kubebuilder markers, and running the generate workflow to produce updated CRDs.

Frequently Asked Questions about eg-contrib-add-api

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

FAQPage Schema
How do I add a new CRD API type in Envoy Gateway?

To add a new CRD API in Envoy Gateway, you define or modify the Go types in api/v1alpha1, apply kubebuilder markers for validation, and run the make generate workflow to produce updated CRD manifests and serialization code.

What is the process for extending an existing Envoy Gateway CRD with new fields?

Extending an existing Envoy Gateway CRD involves updating the Go types in api/v1alpha1, adding or modifying kubebuilder validation markers, and executing code-generation scaffolding to maintain cross-CRD compatibility and serialization.

Do I need kubebuilder markers when modifying Envoy Gateway CRD Go types?

Yes, kubebuilder markers are required when modifying Envoy Gateway CRD Go types to enforce validation rules, ensure API governance, and generate the correct CRD manifests during the controller-gen workflow.

How does code generation work for Envoy Gateway CRD API changes?

Code generation for Envoy Gateway CRD API changes works by running the make generate command, which utilizes controller-gen to process Go types and kubebuilder markers, producing updated CRD manifests and serialization files for PR-driven validation.

Can I reuse shared types when adding multiple CRD APIs in api/v1alpha1?

Yes, you can reuse shared types when adding CRD APIs in api/v1alpha1 to maintain API consistency, avoid regressions in CRD behavior, and align with Envoy Gateway's API design rules and PR governance practices.

What are the limitations when validating cross-CRD compatibility in Envoy Gateway?

Cross-CRD compatibility validation in Envoy Gateway is limited by shared type reuse and API design rules, requiring contributors to run make generate workflows and adhere to PR-driven validation to prevent CRD behavior regressions.