Guide the user through setting up WSL2 clipboard image paste fix - dependency installation, verification, and keybinding configuration
Guides WSL2 users through installing dependencies and configuring keybindings to enable image pasting in Claude Code.
npx claudepluginhub zate/cc-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Use this skill when the user asks to set up, configure, or troubleshoot WSL2 image pasting in Claude Code.
Check that the user is running WSL2:
# Should show Microsoft in version string
grep -qi microsoft /proc/version && echo "WSL detected" || echo "Not WSL"
# Should show WSLInterop
ls /proc/sys/fs/binfmt_misc/WSLInterop* 2>/dev/null && echo "WSL2 confirmed" || echo "WSL1 or not WSL"
Two packages are required:
sudo apt update && sudo apt install -y wl-clipboard imagemagick
Verify:
wl-paste --version
convert --version | head -1
If wl-paste cannot connect to Wayland, ensure WSLg is working:
echo $WAYLAND_DISPLAY # Should show "wayland-0" or similar
ls /mnt/wslg/runtime-dir/wayland-0 2>/dev/null && echo "WSLg OK" || echo "WSLg not available"
The plugin automatically starts the clip2png watcher on session start. Verify it works:
# Test manual conversion
"${CLAUDE_PLUGIN_ROOT}/scripts/clip2png" --once
# Check daemon status
"${CLAUDE_PLUGIN_ROOT}/scripts/clip2png" --status
Windows Terminal intercepts Ctrl+V for text paste. To paste images in Claude Code, bind Alt+V:
Create or edit ~/.claude/keybindings.json:
{
"bindings": [
{
"context": "Chat",
"bindings": {
"alt+v": "chat:imagePaste"
}
}
]
}
Important: The file must have an object with a bindings array at the top level, NOT a bare array.
| Issue | Solution |
|---|---|
wl-paste not found | sudo apt install wl-clipboard |
convert not found | sudo apt install imagemagick |
| Wayland not available | Update to Windows 11 with WSLg support, or run wsl --update |
| Daemon not starting | Check cat /tmp/clip2png.log for errors |
| Image still not pasting | Run wl-paste -l to check clipboard formats; run clip2png --once manually |
| Alt+V not working | Check ~/.claude/keybindings.json format (must be object with bindings array) |
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.