스킬 · 개발 워크플로
그래파이코드베이스 지식 그래프 만들기
코드·문서·PDF·이미지·영상까지 폴더 하나를 통째로 지식 그래프로 만듭니다. 코드는 트리시터 AST로 로컬에서 무료 분석하고(API 키 불필요), 문서·이미지만 세션 모델이나 설정한 Gemini 키로 의미 추출을 합니다. /graphify query "질문" 으로 그래프에 직접 물어볼 수 있고, 연결마다 EXTRACTED(명시적)·INFERRED(추론)를 구분해 표시합니다.

한눈에 보기
- 설치
uv tool install graphifyygraphify install- 처음 시킬 말
- “/graphify . 로 이 프로젝트 구조를 지식 그래프로 만들어줘”
- 난이도
- 개발자용입니다
- 만든 곳
- Graphify-Labs/graphify (커뮤니티)
개발 워크플로 분야 · 바이브코딩·만들기 용도 · 개발자용입니다.
이럴 때 씁니다
큰 코드베이스에서 grep 대신 구조를 물어보고 싶을 때, 여러 저장소를 하나의 그래프로 합쳐 보고 싶을 때
graphify 스킬 설치 한 줄
Claude Code 용 명령입니다. Claude Code 는 터미널뿐 아니라 데스크톱 앱(Mac·Windows), 웹(claude.ai/code), VS Code·JetBrains 확장으로도 씁니다. 어디서 쓰시든 명령을 넣는 자리에 붙여 넣으시면 됩니다. 터미널로 쓰시면 그 터미널이고, 앱·웹·확장으로 쓰시면 그 안의 명령 입력 칸입니다. 헷갈리기 쉬운 곳은 하나입니다. 대화만 하는 Claude 앱의 채팅창은 Claude Code 가 아니라서 여기에 붙여 넣으면 동작하지 않습니다. 터미널로 쓰실 때만 Node.js 가 따로 필요하며, node -v 를 쳐서 버전이 나오면 준비된 것입니다.
uv tool install graphifyy
graphify 스킬 설치 절차 전체
위 한 줄에서 막히셨다면 여기를 보십시오. 터미널로 쓰시는 분을 위해 터미널 여는 법부터 확인 명령까지 순서대로 적어 두었습니다. 데스크톱 앱·웹·편집기 확장으로 쓰시면 터미널 여는 단계는 건너뛰고 명령 입력 칸에 같은 줄을 넣으시면 됩니다.
# graphify 설치
## 1. 도구를 설치합니다
uv tool install graphifyy
graphify install
두 번째 줄까지 실행해야 준비가 끝납니다.
## 2. Claude 를 다시 시작합니다
창만 닫으면 반영되지 않습니다.
Windows 는 작업 표시줄 아이콘에서 종료, macOS 는 Cmd+Q 로 완전히 끄십시오.
## 3. 확인
Claude 에게 "코드베이스 지식 그래프 만들기" 관련 작업을 시켜 보십시오.
설치가 됐다면 알아서 이 도구를 씁니다.
## 주의
npm 이 아니라 Python(uv) 명령줄 도구입니다.
uv 가 없으면 astral.sh/uv 에서 먼저 설치하십시오.이렇게 시켜 보세요
넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.
graphify 스킬 사용법
처음 세 번은 이 순서로 시키십시오. 지시문을 누르면 복사됩니다.
-
나오는 것코드 파일을 로컬에서 읽어 그래프를 만들고 HTML 뷰어로 보여 줍니다. 코드만 있으면 API 키가 필요 없습니다. 노드가 5,000개를 넘으면 경고가 뜨고 묶음 단위로 보여 줍니다.
다음처음에는 저장소 전체 대신 폴더 하나로 시험하십시오. 그래프가 어떻게 생기는지 본 뒤에 범위를 넓히는 편이 빠릅니다.
-
나오는 것그래프에서 답을 찾아 줍니다. 연결마다 EXTRACTED(코드에 명시된 것)와 INFERRED(추론한 것) 표시가 붙습니다.
다음INFERRED 로 표시된 답은 코드를 열어 한 번 확인하십시오. 추론이 틀릴 수 있습니다.
-
나오는 것두 개념이 어떤 파일과 함수를 거쳐 이어지는지 경로가 나옵니다.
다음문서·PDF·이미지까지 넣으려면 Gemini API 키를 설정합니다. 코드만 분석하면 키는 필요 없습니다.
알아 둘 것
Python(uv) 명령줄 도구입니다. npx skills add 계열이 아니라 uv tool install 로 따로 설치합니다. YC 스타트업이 만든 오픈소스 CLI로, 회사 자체 상용 플랫폼(graphify.com)의 무료 버전 성격입니다.
graphify 스킬 안 될 때 확인할 것
코드만 분석하면 API 키가 필요 없습니다
문서·PDF·이미지의 의미 분석에만 Gemini API 키(선택)를 씁니다. 코드만 있는 저장소는 키 없이 전부 로컬에서 끝납니다.
노드가 5,000개 넘으면 시각화 전에 경고가 뜹니다
그래프가 너무 커지면 HTML 뷰어가 무거워질 수 있어 자동으로 커뮤니티 단위로 묶어 보여줍니다.
언제 쓰고, 언제 안 쓰나
코드베이스가 커서 어디서부터 봐야 할지 막막할 때 씁니다. 파일 몇 개짜리 작은 프로젝트라면 그냥 훑어보는 편이 더 빠릅니다.
비슷한 것 중에 왜 이걸
context7 은 남의 라이브러리 문서를 가져오고, 이건 내 폴더를 통째로 읽어 지식 그래프로 만듭니다. 대상이 밖이냐 안이냐가 갈림길입니다. 코드는 로컬에서 무료로 분석하고, 모델은 문서와 이미지에만 씁니다. 큰 저장소를 돌려도 비용이 크게 뛰지 않습니다. 파일 몇 개짜리 프로젝트라면 그냥 열어 보는 편이 빠릅니다. understand-anything 과 하는 일이 겹칩니다. 이건 코드·문서·PDF·이미지·영상까지 폴더를 통째로 먹는 것이 강점이고, 저쪽은 코드에 집중하는 대신 git 변경분 분석·업무 도메인 추출·Figma·온보딩 문서까지 목적별 스킬 아홉 개로 나뉘어 있습니다. 폴더 전체를 하나로 묶어 보려면 이것, 새 팀원에게 넘길 문서가 필요하면 저쪽입니다.
실사용자 후기
GitHub 이슈·디스커션에 실제로 남긴 글을 그대로 옮겼습니다. 아이디는 가렸지만 원문 링크는 진짜입니다. 눌러서 직접 확인하십시오.
Nix 인프라 저장소용 에이전트 툴킷의 핵심 도구로 graphify를 계속 쓰고 있습니다. 실제 nix-darwin 설정(.nix 파일 121개)에 돌려서 전/후 수치까지 재 봤습니다.
AI 코딩 에이전트용 영속 메모리 시스템(agentmemory)을 만들고 있는데, graphify 방식을 뜯어본 뒤 두 도구가 같은 문제의 다른 절반을 풀고 있다는 걸 알았습니다. graphify는 코드가 '무엇인지'를 그리고, 저희 도구는 개발자가 '무엇을 했는지'를 기억합니다.
개발 워크플로 도구를 고를 때
CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.
원본 보기
스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.
GitHub 에서 Graphify-Labs/graphify 열기
이 작업에 쓰는 장비 제휴 링크
에이전트를 오래 돌리거나 저장소를 여러 개 받아 두는 작업입니다.
이 페이지는 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다. 이용자가 내는 금액은 달라지지 않습니다.
별점과 댓글
이 스킬을 써 보신 분의 별점(5점 만점)과 한마디입니다. 작성자는 아이디 앞 3자만 보입니다(예: wor****). 읽는 데는 제한이 없고, 남기는 것은 로그인한 회원만 됩니다. 한 사람이 한 번이며 다시 쓰면 앞의 것을 덮어씁니다.
- 불러오는 중…
자주 묻는 것
graphify(그래파이)는 어떻게 설치합니까?
uv tool install graphifyy 로 설치합니다. 철자에 y 가 둘입니다. 이어서 graphify install 까지 실행해야 준비가 끝납니다. 그다음 /graphify query "질문" 으로 그래프에 묻습니다.
graphify 사용법은 어떻게 됩니까?
세 단계입니다. 먼저 /graphify . 로 지금 폴더를 그래프로 만듭니다. 코드를 로컬에서 읽어 HTML 뷰어로 보여 줍니다. 그다음 /graphify query "인증 모듈이 어디서 호출되는지 찾아줘" 처럼 묻습니다. 두 개념 사이를 보려면 /graphify path "AuthModule" "Database" 를 씁니다. 처음에는 저장소 전체 대신 폴더 하나로 시험하시는 편이 빠릅니다.
그래파이에 API 키가 필요합니까?
코드만 분석하신다면 필요 없습니다. 코드는 트리시터 AST 로 전부 로컬에서 무료로 분석합니다. 문서·PDF·이미지의 의미 추출에만 세션 모델이나 따로 설정한 제미나이 키를 씁니다.
무엇을 그래프로 만들 수 있습니까?
폴더 하나를 통째로 넣습니다. 코드, 문서, PDF, 이미지, 영상까지 들어갑니다. 여러 저장소를 하나의 그래프로 합쳐 볼 수도 있습니다.
그래프가 너무 커지면 어떻게 됩니까?
노드가 5,000개를 넘으면 시각화 전에 경고가 뜹니다. HTML 뷰어가 무거워질 수 있어 자동으로 커뮤니티 단위로 묶어 보여 줍니다.
함께 보면 좋은 스킬
어느 것부터 깔지 모르겠다면 클로드 스킬 추천 15개를 보십시오. 67개를 직접 깔아 보고 골랐습니다.