Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -644,6 +644,9 @@ last_updated: YYYY-MM-DD
4. Include concrete examples
5. Test with `Skill` tool invocation

**Collection-Specific Standards:**
- **rh-virt**: Follow `rh-virt/SKILL_TEMPLATE.md` for enhanced quality standards including mandatory Common Issues and Example Usage sections

### Adding an Agent

1. Create `agents/<agent-name>.md`
Expand Down Expand Up @@ -686,6 +689,19 @@ The `rh-sre` pack is the most complete implementation, demonstrating:

When creating new collection, use `rh-sre` as the architectural reference.

### rh-virt (Quality-Controlled Pattern)

The `rh-virt` pack demonstrates skill quality standardization:
- Comprehensive skill templates (`SKILL_TEMPLATE.md`)
- Risk-based color coding (cyan/green/blue/yellow/red)
- Mandatory Common Issues and Example Usage sections
- Consistent section ordering and formatting

Use `rh-virt` as reference for collections requiring high consistency and maintainability.

When creating new collections, follow the pattern that best matches your needs:
- **Tool-focused domains** (infrastructure, operations) → Follow rh-virt pattern

## Key Principles

### Core Architecture
Expand Down
14 changes: 7 additions & 7 deletions rh-virt/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ claude plugin install openshift-virtualization

The pack provides 5 specialized skills for complete VM lifecycle management:

### 1. **vm-creator** - Virtual Machine Provisioning
### 1. **vm-create** - Virtual Machine Provisioning

Create new virtual machines in OpenShift Virtualization with automatic error diagnosis and workarounds.

Expand Down Expand Up @@ -291,7 +291,7 @@ The server provides two toolsets enabled via `--toolsets core,kubevirt`:

```
User: "Create a VM called web-server in namespace production"
→ vm-creator skill creates the VM
→ vm-create skill creates the VM

User: "Start the web-server VM"
→ vm-lifecycle-manager skill starts the VM
Expand Down Expand Up @@ -383,7 +383,7 @@ Agent: "⏳ Storage cloning in progress... (45%)

```
User: "Create a Fedora VM called test-vm in namespace demo"
→ vm-creator skill creates the VM
→ vm-create skill creates the VM
→ Detects ErrorUnschedulable status
→ Consults docs/troubleshooting/scheduling-errors.md for domain knowledge
→ Diagnoses: Node taints prevent scheduling
Expand All @@ -396,7 +396,7 @@ Agent: "⚠️ VM Scheduling Issue Detected
How would you like to proceed?"

User: "apply workaround"
→ vm-creator patches VM with tolerations
→ vm-create patches VM with tolerations
→ Verifies VM can now be scheduled
→ Reports success

Expand Down Expand Up @@ -460,7 +460,7 @@ MCP server is configured in `.mcp.json`:

### Automatic Diagnosis (Recommended)

The **vm-creator** skill includes automatic error diagnosis and workaround proposals. When VMs encounter scheduling issues:
The **vm-create** skill includes automatic error diagnosis and workaround proposals. When VMs encounter scheduling issues:

1. **Detection**: Skill automatically detects ErrorUnschedulable and other error states
2. **Diagnosis**: Consults `docs/troubleshooting/INDEX.md` and category files to understand root cause
Expand Down Expand Up @@ -492,7 +492,7 @@ The **vm-creator** skill includes automatic error diagnosis and workaround propo
2. Check namespace exists and ServiceAccount has access
3. Verify RBAC permissions for VirtualMachine resources
4. Check cluster resource availability (CPU, memory, storage)
5. Let vm-creator skill run automatic diagnosis (see Workflow 4 above)
5. Let vm-create skill run automatic diagnosis (see Workflow 4 above)

### Skills Not Triggering

Expand Down Expand Up @@ -525,7 +525,7 @@ rh-virt/
│ └── .ai-index/ # Semantic indexing for AI discovery
│ └── semantic-index.json
└── skills/
├── vm-creator/SKILL.md # VM provisioning with auto-diagnosis
├── vm-create/SKILL.md # VM provisioning with auto-diagnosis
├── vm-lifecycle-manager/SKILL.md # VM power management
├── vm-inventory/SKILL.md # VM discovery and status
├── vm-delete/SKILL.md # VM destruction and cleanup
Expand Down
Loading