클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Nerd Font 아이콘 조회 (PUA 유니코드 우회)

Claude Code가 걸러내는 BMP 사설사용영역 Nerd Font 아이콘을 플레이스홀더 문법과 조회 스크립트로 안전하게 읽고 쓰게 해준다.

유틸리티중급★ 462⑂ 37AI 점수 8/10마지막 업데이트: 2026. 8. 23.

무엇을 해주나

  • Claude Code는 BMP 사설사용영역(U+E000–U+F8FF)의 유니코드를 필터링하기 때문에 Powerline, Font Awesome, Devicons 같은 Nerd Font 아이콘이 사라집니다. 이 스킬은 그 우회책을 제공합니다.
  • 필터링되는 아이콘은 {{ U+E0A0 }} 또는 {{ nf-fa-star }} 같은 플레이스홀더로 쓰고, 훅이 실제 문자로 자동 변환합니다.
  • U+F0000 이상(Material Design, nf-md-*)은 그대로 직접 입력 가능하다는 판단 기준을 알려줍니다.
  • lookup-icon.py로 이름 검색, identify-icons.py로 특정 문자 식별, convert-placeholders.py로 수동 변환이 가능합니다.

이런 분께 추천

  • Starship 프롬프트, tmux 테마, zsh/fish 프롬프트, 상태바 설정을 Claude Code로 편집하는 분
  • 터미널 dotfiles에 Nerd Font 아이콘을 많이 쓰는 분
  • 아이콘이 깨지거나 사라지는 문제로 고생한 경험이 있는 분

활용 예시

  1. Starship 설정에 git 브랜치 아이콘을 넣고 싶을 때: lookup-icon.py "git branch"로 이름을 찾고 {{ nf-fa-code_fork }} 형태로 작성.
  2. 기존 tmux 테마 파일을 읽을 때: 훅이 자동으로 각 PUA 문자의 아이콘 이름·코드포인트·필터링 여부를 표시.
  3. 두 설정 파일의 비슷해 보이는 아이콘이 실제로 같은지 identify-icons.py -c "문자"로 확인.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/malob/nix-config/HEAD/configs/claude/plugins/pua-unicode/skills/icon-lookup/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 malob/nix-config 의 configs/claude/plugins/pua-unicode/skills/icon-lookup 폴더를 내 ~/.claude/skills/icon-lookup/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/malob/nix-config.git /tmp/nix-config && mkdir -p ~/.claude/skills && cp -r /tmp/nix-config/configs/claude/plugins/pua-unicode/skills/icon-lookup ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 클론합니다: git clone https://github.com/malob/nix-config.git /tmp/nix-config
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r /tmp/nix-config/configs/claude/plugins/pua-unicode/skills/icon-lookup ~/.claude/skills/
  5. 스크립트가 함께 필요하므로 플러그인 전체(configs/claude/plugins/pua-unicode)를 복사해 두고, ${CLAUDE_PLUGIN_ROOT} 경로가 실제 위치를 가리키도록 확인합니다.
  6. Python 3가 설치되어 있는지 확인합니다: python3 --version
  7. Claude Code를 재시작한 뒤 "Starship 설정에 아이콘 추가해줘" 같이 요청해 스킬이 발동하는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT