스킬 · 개발 워크플로
코드베이스 지식 그래프 만들기
코드·문서·PDF·이미지·영상까지 폴더 하나를 통째로 지식 그래프로 만듭니다. 코드는 트리시터 AST로 로컬에서 무료 분석하고(API 키 불필요), 문서·이미지만 세션 모델이나 설정한 Gemini 키로 의미 추출을 합니다. /graphify query "질문" 으로 그래프에 직접 물어볼 수 있고, 연결마다 EXTRACTED(명시적)·INFERRED(추론)를 구분해 표시합니다.
이럴 때 씁니다
큰 코드베이스에서 grep 대신 구조를 물어보고 싶을 때, 여러 저장소를 하나의 그래프로 합쳐 보고 싶을 때
한 줄로 넣기
터미널에 아래 한 줄을 붙여 넣으십시오.
uv tool install graphifyy
전체 설치 절차
Claude Code 가 아니거나 개별 스킬만 넣고 싶으실 때 보십시오. 눌러서 펼치면 전체가 나옵니다.
# graphify 설치
## 1. 도구를 설치합니다
uv tool install graphifyy
graphify install
두 번째 줄까지 실행해야 준비가 끝납니다.
## 2. Claude 를 다시 시작합니다
창만 닫으면 반영되지 않습니다.
Windows 는 작업 표시줄 아이콘에서 종료, macOS 는 Cmd+Q 로 완전히 끄십시오.
## 3. 확인
Claude 에게 "코드베이스 지식 그래프 만들기" 관련 작업을 시켜 보십시오.
설치가 됐다면 알아서 이 도구를 씁니다.
## 주의
npm 이 아니라 Python(uv) 명령줄 도구입니다.
uv 가 없으면 astral.sh/uv 에서 먼저 설치하십시오.이렇게 시켜 보세요
넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.
알아 둘 것
Python(uv) 명령줄 도구입니다. npx skills add 계열이 아니라 uv tool install 로 따로 설치합니다. YC 스타트업이 만든 오픈소스 CLI로, 회사 자체 상용 플랫폼(graphify.com)의 무료 버전 성격입니다.
자주 막히는 지점
코드만 분석하면 API 키가 필요 없습니다
문서·PDF·이미지의 의미 분석에만 Gemini API 키(선택)를 씁니다. 코드만 있는 저장소는 키 없이 전부 로컬에서 끝납니다.
노드가 5,000개 넘으면 시각화 전에 경고가 뜹니다
그래프가 너무 커지면 HTML 뷰어가 무거워질 수 있어 자동으로 커뮤니티 단위로 묶어 보여줍니다.
언제 쓰고, 언제 안 쓰나
코드베이스가 커서 어디서부터 봐야 할지 막막할 때 씁니다. 파일 몇 개짜리 작은 프로젝트라면 그냥 훑어보는 편이 더 빠릅니다.
개발 워크플로 도구를 고를 때
CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.
원본 보기
스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.
GitHub 에서 Graphify-Labs/graphify 열기