{"id":"icon-lookup","name":"icon-lookup","summary":"ClaudeコードのBMP PUA Unicode(U+E000-U+F8FF)フィルタリングの回避策。","body":"# BMP PUA Unicode Workaround\n\nClaude 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.\n\n## Quick Reference\n\n| Range                          | Status                          | Examples                                    |\n| ------------------------------ | ------------------------------- | ------------------------------------------- |\n| U+E000-U+F8FF (BMP PUA)        | **Filtered** - use placeholders | Powerline, Devicons, Font Awesome, Octicons |\n| U+F0000+ (Supplementary PUA-A) | Works directly                  | Material Design Icons (nf-md-*)             |\n\n## Automatic Features\n\n**When reading files:** A PostToolUse hook automatically identifies all PUA characters, showing icon names, codepoints, and whether they're filtered.\n\n**When writing files:** A PostToolUse hook automatically converts placeholder syntax to actual Unicode characters.\n\n## Placeholder Syntax\n\nWhen writing icons in the filtered BMP PUA range, use placeholder syntax:\n\n- By codepoint: `{{ U+E0A0 }}` (without the spaces)\n- By name: `{{ nf-fa-star }}` (without the spaces)\n\n## Icon Lookup\n\nSearch for icons by name:\n\n```bash\npython3 ${CLAUDE_PLUGIN_ROOT}/scripts/lookup-icon.py \"<search query>\"\n```\n\nExample searches:\n\n- `git branch` → finds git-related icons\n- `folder` → finds folder/directory icons\n- `wizard` → finds wizard icons\n\n## Character Identification\n\nIdentify a specific character:\n\n```bash\n# Direct argument (this is nf-md-battery, a Supplementary PUA icon)\npython3 ${CLAUDE_PLUGIN_ROOT}/scripts/identify-icons.py -c \"󰁹\"\n\n# From stdin\necho \"󰁹\" | python3 ${CLAUDE_PLUGIN_ROOT}/scripts/identify-icons.py -\n```\n\n## Workflow\n\n1. **Reading files** - Hook automatically shows icon info; use this to understand what icons are present\n2. **Writing icons** - Search with lookup script, then use placeholder syntax for filtered icons\n3. **Comparing icons** - Use identify script to check if two characters are the same icon\n4. **Material Design Icons** (U+F0000+) can be written directly without placeholders\n\n## Manual Conversion\n\nIf placeholders weren't converted (e.g., hook didn't run):\n\n```bash\n${CLAUDE_PLUGIN_ROOT}/scripts/convert-placeholders.py /path/to/file\n```","author":"@malob","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/malob/nix-config/tree/master/configs/claude/plugins/pua-unicode/skills/icon-lookup","license":"MIT","category":"writing","lang":"en","tokens":519,"stars":0,"calls30d":1,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":[]}}