kubevirt-ai-helpers: Instructions file for Claude Code

AGENTS.md - Guide for AI Coding Agents

This guide helps AI coding agents navigate and contribute to the kubevirt-ai-helpers repository, which contains Claude Code plugins for automating KubeVirt virtualization workflows.

Repository Overview

This repository contains Claude Code plugins specifically focused on KubeVirt virtualization, organized under the plugins/ directory. Each plugin provides slash commands that can be invoked in Claude Code to automate KubeVirt-specific workflows.

Repository Structure:

kubevirt-ai-helpers/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace registration
├── plugins/
│   ├── {plugin-name}/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json       # Plugin metadata
│   │   ├── commands/
│   │   │   └── *.md              # Command definitions
│   │   ├── skills/               # Optional: Task-specific implementation details
│   │   │   └── {skill-name}/
│   │   │       └── SKILL.md      # Skill documentation
│   │   └── README.md             # Plugin documentation
│   └── ...
└── README.md

Plugin Conventions

1. Plugin Structure

Every plugin must follow this structure:

plugins/{plugin-name}/
├── .claude-plugin/
│   └── plugin.json               # Required: Plugin metadata
├── commands/
│   └── {command-name}.md         # Required: At least one command
├── skills/                        # Optional: Complex implementation details
│   └── {skill-name}/
│       ├── SKILL.md               # Detailed implementation guide
│       ├── README.md              # User-facing documentation
│       └── *.py                   # Optional: Helper scripts
└── README.md                      # Recommended: Plugin documentation

2. Plugin Metadata (plugin.json)

Location: plugins/{plugin-name}/.claude-plugin/plugin.json

{
  "name": "plugin-name",
  "description": "Brief description of what this plugin does",
  "version": "1.0.0",
  "author": {
    "name": "KubeVirt Contributors"
  }
}