icon-lookup

# BMP PUA Unicode Workaround Claude Code filters Unicode characters in the BMP Private Use Area (U+E000-U+F8FF), which includes most Nerd Font icons. This skill provides tools for working with these icons. ## Quick Reference | Range | Status | Examples | | ------------------------------ | ------------------------------- | ------------------------------------------- | | U+E000-U+F8FF (BMP PUA) | **Filtered** - use placeholders | Powerline, Devicons, Font Awesome, Octicons | | U+F0000+ (Supplementary PUA-A) | Works directly | Material Design Icons (nf-md-*) | ## Automatic Features **When reading files:** A PostToolUse hook automatically identifies all PUA characters, showing icon names, codepoints, and whether they're filtered. **When writing files:** A PostToolUse hook automatically converts placeholder syntax to actual Unicode characters. ## Placeholder Syntax When writing icons in the filtered BMP PUA range, use placeholder syntax: - By codepoint: `{{ U+E0A0 }}` (without the spaces) - By name: `{{ nf-fa-star }}` (without the spaces) ## Icon Lookup Search for icons by name: ```bash python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lookup-icon.py "<search query>" ``` Example searches: - `git branch` → finds git-related icons - `folder` → finds folder/directory icons - `wizard` → finds wizard icons ## Character Identification Identify a specific character...