Icon Lookup

Claude Code filters Nerd Font icons in the U+E000-U+F8FF range, which breaks most Powerline, Font Awesome, and Devicon glyphs in your Starship configs and shell prompts. This skill works around it with placeholder syntax like {{U+E0A0}} or {{nf-fa-star}} that auto-converts on write, plus scripts to search the icon database and identify what character you're looking at. Material Design icons in the supplementary PUA range work fine without placeholders. The hooks run automatically when you edit config files, so you write placeholders and get real Unicode. Honestly a bit of ceremony for what should just work, but if you maintain dotfiles with custom prompts it beats manually looking up codepoints.

GitHub stars: 460
last updated: Jun 7, 2026

View on GitHub

Install

$ npx -y skills add malob/nix-config --skill icon-lookup --agent claude-code

Installs into .claude/skills of the current project.

Files

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-*)