What problem does it solve?
Fine-tuning a vision-language model often fails silently: the loss curve looks normal while the model learns nothing, due to image-placeholder mismatches or wrong resolution budgets. This Skill provides a validated adapter configuration recipe so VLM fine-tunes actually learn.
Core Features & Use Cases
- Consensus LoRA Recipe: Freeze the vision tower and projector, apply LoRA to the LLM only at r=8-16, alpha=16-32, with QLoRA permitted only alongside a frozen vision tower.
- Unfreezing Guidance: Escalate to unfreezing the last six ViT layers only for genuine visual domain shift, with vision learning rate 5-10x lower than the LLM rate.
- Silent-Failure Detection: Pre-training validation checklist covering image-tag-to-media 1:1 mapping, min_pixels/max_pixels resolution budgets, and loss-mask verification per architecture family (Qwen-VL, InternVL, Gemma 3).
- Use Case: You are adapting a VLM to read dense technical diagrams and the frozen-tower baseline plateaus; the Skill tells you to unfreeze the last six ViT layers at a reduced vision LR and validates the collator before training.
Quick Start
Ask the agent to configure a LoRA fine-tune for your vision-language model on your image-text dataset and validate the data collator before training.