Toolverse
All skills

icon-lookup

by malob

Workaround for Claude Code filtering BMP PUA Unicode (U+E000-U+F8FF). Supplementary PUA Nerd Font icons like 󰊤 󱃾 󰁹 (U+F0000+, e.g. nf-md-github, nf-md-kubernetes, nf-md-battery) can be written directly. BMP PUA icons (Powerline, Font Awesome, Devicons) require placeholder

Installation

Pick a client and clone the repository into its skills directory.

Installation

Quick info

Author
malob
Category
DevOps
Views
1

About this skill

Workaround for Claude Code filtering BMP PUA Unicode (U+E000-U+F8FF). Supplementary PUA Nerd Font icons like 󰊤 󱃾 󰁹 (U+F0000+, e.g. nf-md-github, nf-md-kubernetes, nf-md-battery) can be written directly. BMP PUA icons (Powerline, Font Awesome, Devicons) require placeholder syntax like {{ U+E0A0 }} or {{ nf-fa-star }} (without spaces), which hooks auto-convert. Invoke when reading or writing Starship configs, tmux themes, shell prompts, or statuslines.

How to use

  1. Zainstaluj umiejętność w Claude, dodając ją do katalogu pluginów. Skill będzie automatycznie aktywny podczas pracy z plikami zawierającymi znaki Unicode z zakresu Private Use Area.

  2. Gdy czytasz plik z ikonami Unicode, hook PostToolUse automatycznie identyfikuje wszystkie znaki PUA, wyświetlając ich nazwy, kody punktów i informację, czy są filtrowane przez Claude.

  3. Podczas pisania ikon w filtrowanym zakresie BMP PUA (U+E000-U+F8FF) używaj składni zastępczej zamiast bezpośredniego wpisywania znaku. Wpisz {{ U+E0A0 }} dla ikony o kodzie heksadecymalnym lub {{ nf-fa-star }} dla ikony o nazwie Nerd Font (bez spacji wewnątrz nawiasów).

  4. Aby znaleźć ikonę, użyj komendy wyszukiwania: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lookup-icon.py "fraza". Wpisz słowa kluczowe, takie jak "git branch" dla ikon związanych z gitem, "folder" dla ikon katalogów lub "wizard" dla ikon czarodzieja.

  5. Po wpisaniu symboli zastępczych hook PostToolUse automatycznie konwertuje je na rzeczywiste znaki Unicode podczas zapisywania pliku. Ikony z zakresu U+F0000+ (Material Design Icons) możesz wpisywać bezpośrednio bez symboli zastępczych.

  6. Umiejętność jest szczególnie przydatna przy edycji konfiguracji Starship, tematów tmux, promptów powłoki lub linii statusu, gdzie ikony Unicode są powszechnie używane.

Related skills