icon-lookup

Identify and convert BMP PUA Unicode icons using placeholder syntax.

459|37|Updated Mar 29, 2019
One-click install
npx skills add https://github.com/malob/nix-config --skill icon-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: icon-lookup
Source: https://github.com/malob/nix-config/tree/main/configs/claude/plugins/pua-unicode/skills/icon-lookup
Command: npx skills add https://github.com/malob/nix-config --skill icon-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude-filtered environments can strip or misrender BMP Private Use Area Unicode icons, breaking visual cues in prompts and UI text. This skill provides tooling to identify, convert, and manage icons using placeholder syntax to ensure consistent rendering during editing and automation.

Core Features & Use Cases

  • Icon identification: detect and annotate BMP PUA characters in text.
  • Placeholder workflow: convert between placeholder syntax and actual icons for BMP PUA ranges.
  • Manual & automated support: supports PostToolUse hooks and Python scripts to streamline reading and writing icon data.
  • Use Case: ensure icons render consistently in shell prompts, statuslines, and configuration files across Claude-filtered contexts.

Quick Start

Identify BMP PUA icons in your files and apply placeholder conversions as needed, for example: python3 ${CLAUDE_PLUGIN_ROOT}/scripts/identify-icons.py -c "󰁹" python3 ${CLAUDE_PLUGIN_ROOT}/scripts/convert-placeholders.py /path/to/file

Frequently Asked Questions about icon-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do BMP PUA Unicode icons get stripped or misrendered in Claude workflows?

BMP PUA Unicode icons get misrendered in Claude workflows because Claude-filtered environments strip unmapped Private Use Area characters from text, breaking visual cues in prompts, configuration files, and UI labels.

How do I identify BMP PUA icons in configuration files and shell prompts?

You identify BMP PUA icons in configuration files and shell prompts by running Python scripts that detect and annotate Private Use Area characters in text, enabling consistent rendering across editors and dashboards.

What is placeholder syntax for converting Unicode icons in Claude-filtered text?

Placeholder syntax for converting Unicode icons uses formats like {{ U+E0A0 }} or {{ nf-fa-star }} to represent BMP PUA characters, ensuring icons render consistently during editing and automation in Claude workflows.

Can I automate BMP PUA icon conversion using PostToolUse hooks?

Yes, you can automate BMP PUA icon conversion using PostToolUse hooks alongside Python scripts, streamlining the process of reading and writing icon data in Claude-filtered contexts without manual intervention.

Do I need Python to manage BMP PUA icons in Claude text processing?

Yes, you need Python to manage BMP PUA icons in Claude text processing, as the workflow requires Python scripts for icon lookup, identification, and placeholder conversions across shells, editors, and dashboards.