Use this skill when you want to adapt a pre-trained vision model to a new task by prepending learnable visual prompt tokens, training only the prompts. Avoid it when full fine-tuning is affordable or LoRA is preferred.
Skill metadata
Skill type: parameter-efficient-visual-adaptation
Paper kind: operational-method
Actionability: high
Evidence quality: full_paper
Goal
Adapt pre-trained vision models to new tasks by prepending a small number of learnable visual prompt tokens to the input, training only the prompt tokens while keeping the model frozen.
Problem signature
Modality: images with learnable visual prompt tokens.
Data state: task-specific data used to train visual prompts only.
Scale regime: any dataset; only prompt tokens are trained.
Model requirement: Pre-trained ViT with frozen weights.
Use when
You want extremely parameter-efficient visual adaptation.
You need to adapt to many tasks without full fine-tuning.
You want to keep the vision model frozen.
Do not use when
Full fine-tuning is affordable.
LoRA provides better results.
You need to change the model architecture.
Required inputs
pretrained_vit: Frozen pre-trained ViT.
task_data: Task-specific training data.
visual_prompts: Learnable prompt tokens to prepend.
Optional inputs
deep_prompting: Prompts at multiple layers (VPT-Deep).
Outputs
adapted_model: Vision model adapted through visual prompts.
A small number of prompt tokens can adapt a frozen model.
Visual prompting is analogous to language prompting.
Frozen models preserve general representations.
Procedure
Initialize visual prompts
Action: Create learnable prompt tokens.
Why: Prompts are the only trainable parameters.
Note: See paper for details.
Prepend to input
Action: Add prompts before image patch tokens.
Why: Prompts influence model processing.
Note: See paper for details.
Train prompts only
Action: Train only the prompt tokens on task data.
Why: Extremely parameter-efficient adaptation.
Note: See paper for details.
Evaluate adaptation
Action: Test on the target task.
Why: Validates prompt-based adaptation.
Note: See paper for details.
Parameters to set
num_prompt_tokens — Role: Number of visual prompt tokens. How to set: 10-100 tokens. Default/range: 50. Effect: More tokens provide more adaptation capacity.
prompt_depth — Role: Where to add prompts. How to set: VPT-Shallow (input only) or VPT-Deep (all layers). Default/range: VPT-Deep. Effect: Deep prompting provides more capacity.
Validation checks
Prompt-tuned model should approach full fine-tuning quality.
Only prompt tokens should be updated.
The approach should work across diverse tasks.
Failure modes
Very few prompts may be insufficient.
Some tasks may require more adaptation.
Prompt-based adaptation may not match LoRA quality.
1---2name: visual-prompt-tuning-arxiv-2203-12119v23description: Visual Prompt Tuning4---5# Visual Prompt Tuning67## One-line decision8Use this skill when you want to adapt a pre-trained vision model to a new task by prepending learnable visual prompt tokens, training only the prompts. Avoid it when full fine-tuning is affordable or LoRA is preferred.910## Skill metadata11- **Skill type**: parameter-efficient-visual-adaptation12- **Paper kind**: operational-method13- **Actionability**: high14- **Evidence quality**: full_paper1516## Goal17Adapt pre-trained vision models to new tasks by prepending a small number of learnable visual prompt tokens to the input, training only the prompt tokens while keeping the model frozen.1819## Problem signature20- Modality: images with learnable visual prompt tokens.21- Data state: task-specific data used to train visual prompts only.22- Scale regime: any dataset; only prompt tokens are trained.23- Model requirement: Pre-trained ViT with frozen weights.2425## Use when26- You want extremely parameter-efficient visual adaptation.27- You need to adapt to many tasks without full fine-tuning.28- You want to keep the vision model frozen.2930## Do not use when31- Full fine-tuning is affordable.32- LoRA provides better results.33- You need to change the model architecture.3435## Required inputs36- **pretrained_vit**: Frozen pre-trained ViT.37- **task_data**: Task-specific training data.38- **visual_prompts**: Learnable prompt tokens to prepend.3940## Optional inputs41- **deep_prompting**: Prompts at multiple layers (VPT-Deep).4243## Outputs44- **adapted_model**: Vision model adapted through visual prompts.45- **prompt_tokens**: Learned task-specific visual prompt tokens.4647## Assumptions and prerequisites48- A small number of prompt tokens can adapt a frozen model.49- Visual prompting is analogous to language prompting.50- Frozen models preserve general representations.5152## Procedure531. **Initialize visual prompts**54 Action: Create learnable prompt tokens.55 Why: Prompts are the only trainable parameters.56 Note: See paper for details.572. **Prepend to input**58 Action: Add prompts before image patch tokens.59 Why: Prompts influence model processing.60 Note: See paper for details.613. **Train prompts only**62 Action: Train only the prompt tokens on task data.63 Why: Extremely parameter-efficient adaptation.64 Note: See paper for details.654. **Evaluate adaptation**66 Action: Test on the target task.67 Why: Validates prompt-based adaptation.68 Note: See paper for details.6970## Parameters to set71- **num_prompt_tokens** — Role: Number of visual prompt tokens. How to set: 10-100 tokens. Default/range: 50. Effect: More tokens provide more adaptation capacity.72- **prompt_depth** — Role: Where to add prompts. How to set: VPT-Shallow (input only) or VPT-Deep (all layers). Default/range: VPT-Deep. Effect: Deep prompting provides more capacity.7374## Validation checks75- Prompt-tuned model should approach full fine-tuning quality.76- Only prompt tokens should be updated.77- The approach should work across diverse tasks.7879## Failure modes80- Very few prompts may be insufficient.81- Some tasks may require more adaptation.82- Prompt-based adaptation may not match LoRA quality.8384## Adaptation notes for VLM training85- Visual prompt tuning provides efficient VLM adaptation.86- Apply to domain-specific VLM adaptation with minimal data.87- Compare to LoRA for the best efficient adaptation method.8889## Implementation notes90- Implement prompt tokens as learnable parameters.91- Use VPT-Deep for best results.92- Compare to full fine-tuning and LoRA.9394## Evidence from the paper95- Visual Prompt Tuning adapts ViTs with only 0.1% trainable parameters.96- VPT matches full fine-tuning on most tasks.97- Visual prompts are analogous to language prompts for adaptation.98- The approach enables efficient multi-task VLM adaptation.99100## Source paper101- **Title**: Visual Prompt Tuning102- **Year**: 2022103- **Venue**: ECCV104- **Paper ID**: arxiv-2203.12119v2105- **URL**: http://arxiv.org/abs/2203.12119v2106- **arXiv ID**: 2203.12119v2
Run npx skillmds@latest add jiachen-t-wang/visual-prompt-tuning-arxiv-2203-12119v2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Visual Prompt Tuning It is listed under AI & ML on SkillMD.
SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Jiachen-T-Wang (@jiachen-t-wang) published this skill. Their other Agent Skills are listed on their SkillMD profile.