hermes-figma 가이드

Hermes에서 Figma 파일을 읽거나 쓰기 직전, fileKey와 호출 순서를 고정할 때

한 줄 결과물: Figma를 읽거나 쓰기 전에 fileKey 식별, 세션 생성, 읽기 범위, 공식 스킬 로드를 고정한 호출 순서.

언제 쓰나

Figma 열기 순서: URL에서 fileKey 추출부터 스크린샷 확인까지 6단계

이 스킬은 이미지가 아니라 "순서"가 결과물이다. 위 그림이 한 번의 요청에서 지켜야 할 호출 순서다.

입력	값
링크	`figma.com/design/AbC123xyz/앱?node-id=12-34`
뽑아낸 값	fileKey `AbC123xyz`, nodeId `12:34`(`-`를 `:`로 바꾼다)
읽기	`get_metadata(fileKey)`는 nodeId 없이 페이지 목록만
쓰기 전	`skill://figma/figma-use`를 읽는다

링크 또는 저장된 키를 준비한다. 링크도 키도 없으면 에이전트는 추측하지 않고 묻는다.

hermes-figma 스킬을 따라 이 Figma 파일을 읽어 줘.
https://www.figma.com/design/AbC123xyz/앱?node-id=12-34

서버를 고른다. 기본은 원격 https://mcp.figma.com/mcp. 데스크톱 127.0.0.1:3845는 Figma 앱이 열려 있고 Dev Mode MCP가 켜져 있을 때만 쓴다. 현재 선택 영역은 데스크톱에서만 동작한다.
fileKey와 nodeId를 뽑는다. /design/{fileKey}/ 또는 /file/{fileKey}/에서 fileKey, node-id의 -는 :로 바꾼다. 받은 키는 메모리에 남겨 같은 파일에 링크를 다시 묻지 않는다.
세션을 만든다. create_session(fileKey)을 호출하고 반환된 sessionId를 이후 호출에 그대로 넘긴다.
읽는다. 파일 파악은 get_metadata(fileKey)만. 프레임 링크가 있으면 그 노드만 읽고, 출력이 크면 자식 윤곽을 보고 필요한 자식만 get_design_context로 읽는다.
쓰기 전에 공식 스킬을 읽는다. use_figma 전에는 figma-use, 화면 조립은 figma-generate-design, 컴포넌트·토큰 생성은 figma-generate-library도 함께. search_design_system으로 기존 것을 먼저 찾는다.
한 섹션씩 만들고 get_screenshot으로 잘림과 겹침을 본다. 보지 않은 것을 확인했다고 쓰지 않는다. 게시와 공유는 사람이 한다.