Skills support #848
Merged
Skills support #848
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Provides guidance for implementing new virtualization providers: - Provider architecture and directory structure - Required methods and return value patterns - Registration in config.py and setup.py - Reference implementations
Provides guidance for creating kcli plan files: - YAML structure with Jinja2 templating - Resource types (VM, profile, network, image, container) - Parameter substitution and conditionals - Common VM parameters and plan execution commands
Provides guidance for Kubernetes cluster deployment: - Supported cluster types (OpenShift, kubeadm, k3s, etc.) - Basic commands and key parameters - Scaling operations and troubleshooting - Cloud provider integration
Provides guidance for VM lifecycle management: - Create, list, start, stop, delete VMs - Disk and NIC operations - Snapshots and cloning - Configuration hierarchy and common parameters - Troubleshooting tips
Provides guidance for testing and code quality: - Development setup and linting commands - pytest usage and test structure - Integration testing with plans - Pre-commit validation checklist - CI/CD pipeline overview
Improvements to existing skills: - kcli-provider-development: Add 50+ missing methods including snapshots, buckets, security groups, subnets, DNS, and update operations; expand provider reference list with line counts; add provider complexity guide - kcli-plan-authoring: Fix incorrect Jinja filters path; document all 25 custom filters organized by category - kcli-testing: Document bottle.py exclusion; note flake8 E501 difference from CI linting - kcli-cluster-deployment: Add generic/kubernetes cluster type; add RKE2 and MicroShift deployment sections New skill: - kcli-configuration: Comprehensive guide for config.yml setup, all provider types (KVM, AWS, GCP, Azure, KubeVirt, OpenStack, oVirt, vSphere, Proxmox, Hetzner, IBM), profiles, and troubleshooting
New skill combining official documentation and existing skills into a single user-focused reference covering: - Quick reference for all major commands - VM creation with common parameters and advanced examples - VM management (list, info, state control, snapshots) - Plans (Infrastructure as Code) with Jinja2 templating - Kubernetes cluster deployment (all types) - Image management and common images - Network and storage operations - Provider/client management - Profiles for reusable VM templates - Debug and troubleshooting tips - Configuration file reference - Container mode usage - Practical tips and shortcuts
improve Claude Code SKILLS support
There was a problem hiding this comment.
Pull request overview
This pull request adds comprehensive skill documentation for kcli, organizing reference material into seven focused guides covering different aspects of the tool. The documentation provides detailed user guides, configuration references, and developer resources to improve onboarding and advanced usage of kcli.
Changes:
- Added complete user guide with quick reference, VM operations, plans, clusters, and troubleshooting tips
- Created focused guides for VM operations, testing, provider development, plan authoring, configuration, and cluster deployment
- Organized documentation by use case to support Claude AI skill-based assistance
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
.claude/skills/kcli/SKILL.md |
Comprehensive user guide covering all major kcli workflows, commands, and common operations |
.claude/skills/kcli-vm-operations/SKILL.md |
Detailed VM lifecycle operations including creation, management, snapshots, and troubleshooting |
.claude/skills/kcli-testing/SKILL.md |
Testing and code quality guidelines with linting rules, pytest commands, and CI/CD reference |
.claude/skills/kcli-provider-development/SKILL.md |
Provider development guide with required interfaces, methods, and implementation steps |
.claude/skills/kcli-plan-authoring/SKILL.md |
Plan authoring reference with YAML structure, Jinja2 templating, and debugging guidance |
.claude/skills/kcli-configuration/SKILL.md |
Configuration guide for all provider types, client management, and troubleshooting |
.claude/skills/kcli-cluster-deployment/SKILL.md |
Kubernetes cluster deployment for all supported distributions with parameters and troubleshooting |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Owner
|
huge thanks !!!!! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This pull request adds comprehensive skill documentation for kcli, including configuration, plan authoring, provider development, and cluster deployment. These markdown files provide detailed guides and reference material for users and developers working with kcli, improving onboarding, troubleshooting, and advanced usage.
New skill documentation added:
Add comprehensive kcli user skill
New skill combining official documentation and existing skills into
a single user-focused reference covering:
Cluster Deployment & Management:
.claude/skills/kcli-cluster-deployment/SKILL.mdwith detailed instructions for deploying and managing Kubernetes clusters using kcli, covering supported cluster types, commands, parameters, scaling, troubleshooting, and cloud provider notes.Configuration & Provider Setup:
.claude/skills/kcli-configuration/SKILL.mdexplaining kcli configuration files, provider setup for various platforms (KVM, AWS, GCP, Azure, etc.), environment variables, and troubleshooting connection and SSH issues.Plan Authoring & Jinja2 Templating:
.claude/skills/kcli-plan-authoring/SKILL.mdwith guidance on writing kcli plan YAML files, using Jinja2 templating, available resource types, custom filters, and debugging plan execution.Provider Development:
.claude/skills/kcli-provider-development/SKILL.mddetailing how to implement new kcli providers, including required interfaces, method contracts, registration steps, and reference implementations.