kagent-dev

Guide kagent development with CRD modifications, E2E testing, and PR workflows.

3.5k|695|Updated Jan 21, 2025
One-click install
npx skills add https://github.com/kagent-dev/kagent --skill kagent-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kagent-dev
Source: https://github.com/kagent-dev/kagent/tree/main/.claude/skills/kagent-dev
Command: npx skills add https://github.com/kagent-dev/kagent --skill kagent-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide for developing, testing, and deploying the kagent framework itself, enabling efficient contributions and troubleshooting.

Core Features & Use Cases

  • CRD Modifications: Step-by-step instructions for adding or updating Kubernetes Custom Resource Definitions.
  • Testing Workflows: Guidance on running unit tests, golden file regeneration, and end-to-end tests.
  • Deployment & Debugging: Local development setup, CI troubleshooting, and PR review best practices.
  • Use Case: You're a kagent maintainer tasked with adding a new feature that requires modifying the Agent CRD. This Skill will guide you through the entire process, from code changes to testing and deployment.

Quick Start

Use the kagent-dev skill to locally set up a Kind cluster and install kagent.

Frequently Asked Questions about kagent-dev

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

FAQPage Schema
How do I modify Kubernetes CRDs for kagent development?

To modify Kubernetes CRDs for kagent, follow step-by-step instructions for adding or updating Custom Resource Definitions, including necessary code generation and translator updates to ensure schema changes are properly reflected in the kagent framework.

How do I run end-to-end tests and regenerate golden files for kagent?

Run end-to-end tests and regenerate golden files by executing specific testing workflows designed for the kagent codebase. This includes running unit tests, triggering golden file regeneration commands, and analyzing E2E test failures to ensure codebase stability.

What is the best way to set up a local kagent deployment for debugging?

The best way to set up local kagent deployment for debugging is to use the Skill's quick start guide to locally provision a Kind cluster and install kagent, facilitating direct CI troubleshooting and local development testing.

How do I troubleshoot CI/CD failures when contributing to the kagent codebase?

Troubleshoot CI/CD failures when contributing to the kagent codebase by utilizing provided local development and debugging guidance. This allows you to replicate CI environments, analyze end-to-end test failures, and validate code changes before submitting a PR.

Do I need a Kind cluster to test kagent features locally?

Yes, you need a Kind cluster to test kagent features locally. The deployment and debugging workflow specifically requires setting up a local Kind cluster to install kagent and validate modifications before initiating the PR review process.