스킬 · 개발 워크플로
코드베이스 통째로 파악하기 9종
저장소 하나에 스킬 아홉 개가 들어 있습니다. 코드베이스를 지식 그래프로 만들고(understand), 브라우저 대시보드로 열어 보고(dashboard), 그래프에 말로 물어보고(chat), git 변경분의 영향 범위와 위험을 짚고(diff), 업무 도메인을 뽑아 흐름도로 만들고(domain), 파일이나 함수를 깊게 설명하고(explain), Figma 파일을 분석하고(figma), 새로 온 사람을 위한 온보딩 문서를 만듭니다(onboard).
개발 워크플로 분야 · 바이브코딩·만들기 용도 · 개발자용입니다.
이럴 때 씁니다
남이 만든 큰 코드베이스에 처음 들어갈 때, 새 팀원에게 넘길 문서를 만들 때
한 줄로 넣기
Claude Code 용입니다. Claude 데스크톱 앱의 채팅창이 아니라 컴퓨터의 터미널에 붙여 넣으십시오 — macOS 는 터미널, Windows 는 PowerShell 입니다. Node.js 가 깔려 있어야 하며, node -v 를 쳐서 버전이 나오면 준비된 것입니다.
npx skills add https://github.com/Egonex-AI/Understand-Anything -g -a claude-code
뒤의 두 가지는 붙여 두시는 편이 좋습니다. -g 는 계정 전체에 넣는다는 뜻으로, 없으면 지금 열려 있는 폴더에만 깔려 다른 곳에서는 스킬이 보이지 않습니다. -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다. 이걸 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 Failed to install 이 뜨는데, 실제로는 설치가 된 상태라 헷갈립니다.
전체 설치 절차
터미널을 처음 여시거나, 위 한 줄에서 막히셨다면 여기를 보십시오. 터미널 여는 법부터 확인 명령까지 순서대로 적어 두었습니다.
# Egonex-AI/Understand-Anything 설치
## 0. 어디에 붙여 넣나
Claude 데스크톱 앱의 채팅창이 아닙니다. 컴퓨터의 터미널입니다.
macOS Spotlight(Command + 스페이스)에서 "터미널" 을 여십시오
Windows 시작 메뉴에서 "PowerShell" 을 여십시오
Node.js 가 있어야 합니다. 터미널에 node -v 를 쳐서 v20.1.2 처럼
버전이 나오면 준비된 것입니다. "찾을 수 없습니다" 가 나오면
nodejs.org 에서 LTS 버전을 먼저 설치하십시오.
## 1. 넣기
npx skills add https://github.com/Egonex-AI/Understand-Anything -g -a claude-code
성공하면 이 한 줄이 나옵니다.
Installed 1 skill → ~/.claude/skills/...
-g 는 계정 전체에 넣는다는 뜻입니다(~/.claude/skills).
어느 폴더에서 Claude Code 를 열든 쓸 수 있습니다.
빼면 지금 열려 있는 폴더에만 깔려서(./.claude/skills), 다른 데서
열면 스킬이 안 보입니다. "깔았는데 안 보인다" 는 대개 이것입니다.
-a claude-code 는 Claude Code 에만 넣는다는 뜻입니다.
빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간
"Failed to install" 이 뜹니다. 실제로는 설치가 끝난 상태인데
실패한 것처럼 보여 여기서 멈추기 쉽습니다.
저장소에 스킬이 여러 개면 어느 것을 넣을지 물어봅니다.
미리 보시려면 --list 를 붙이십시오.
npx skills add https://github.com/Egonex-AI/Understand-Anything --list
## 2. Claude Code 를 다시 시작합니다
이미 claude 를 실행 중이셨다면 끝내고 다시 실행하십시오.
실행 중인 세션은 시작할 때 읽은 목록을 그대로 씁니다.
데스크톱 앱을 껐다 켜는 것이 아닙니다. 터미널의 claude 를 말합니다.
## 3. 확인
npx skills list -g
전역으로 넣은 스킬이 이름과 경로와 함께 나옵니다.
-g 를 빼면 지금 폴더의 스킬만 보이므로 "없다" 고 나올 수 있습니다.
## 4. 쓰기
"코드베이스 통째로 파악하기 9종" 관련 작업을 시켜 보십시오.
스킬이 붙었다면 알아서 불러 씁니다.이렇게 시켜 보세요
넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.
알아 둘 것
명령 뒤에 --language ko 를 붙이면 요약과 설명을 한국어로 냅니다. 직접 설치해 아홉 개가 다 들어오는 것과 이 옵션을 확인했습니다. 코드 분석은 컴퓨터 안에서만 돌지만 Figma 분석만은 밖으로 나갑니다.
자주 막히는 지점
아홉 개가 한꺼번에 들어옵니다
필요한 하나만 넣고 싶으면 --skill understand-onboard 처럼 이름을 지정하십시오.
Figma 는 토큰이 따로 필요합니다
FIGMA_TOKEN 환경변수를 미리 설정해야 합니다. 이 스킬만 api.figma.com 으로 나가고 나머지는 컴퓨터 안에서 끝납니다.
큰 저장소는 오래 걸립니다
7단계로 나눠 진행 상황을 알려 주기는 하지만, 처음 한 번은 시간을 잡고 돌리셔야 합니다.
대시보드는 로컬 서버입니다
127.0.0.1 에 서버를 띄우고 주소를 알려 줍니다. 인터넷에 올라가는 것이 아닙니다.
언제 쓰고, 언제 안 쓰나
코드베이스를 처음 파악하거나 남에게 넘겨야 할 때 씁니다. 파일 몇 개짜리 프로젝트라면 그냥 열어 보는 편이 빠릅니다.
비슷한 것 중에 왜 이걸
graphify 와 하는 일이 겹칩니다. 가르는 지점은 두 가지입니다. 첫째, 다루는 대상 — graphify 는 코드·문서·PDF·이미지·영상까지 폴더를 통째로 먹고, 이것은 코드에 집중하는 대신 git 변경분·업무 도메인·Figma·온보딩 문서처럼 코드 주변의 일까지 갑니다. 둘째, 쓰는 모양 — graphify 는 그래프를 만들고 질문하는 두 갈래인데, 이것은 목적별로 스킬이 아홉 개로 나뉘어 있어 필요한 것만 골라 부릅니다. 새 팀원에게 넘길 문서가 필요하면 이쪽에만 있습니다. context7 은 남의 라이브러리 공식 문서를 가져오는 쪽이라 방향이 반대입니다. 한국어로 결과를 받고 싶으면 --language ko 가 있는 이쪽이 편합니다.
개발 워크플로 도구를 고를 때
CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.
원본 보기
스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.
GitHub 에서 Egonex-AI/Understand-Anything 열기