30일 챌린지 오픈 알림 받기
← 모든 가이드

에이전트 워크플로

나만의 자비스 만들기 — 스킬 5개 템플릿 + HUD 프롬프트 + vault 구조

Claude Code
지금 다 못 읽겠다면 · 이 가이드 링크를 메일로 받기

목차 · 6개 섹션

영상에서 말씀드린 스킬 5개, HUD 프롬프트, vault 구조입니다. 복사해서 그대로 쓰시면 됩니다.


시작 전에

부품어디서 받나비용
클로드 코드claude.com/claude-code구독 필요
옵시디언obsidian.md무료
로컬 STTwhisper.cpp무료
로컬 TTSpiper1-gpl무료

미리 말씀드리면, 목소리 붙이는 3단계에서 한 번은 막히실 겁니다. 마이크 권한이나 모델 내려받는 데서요. 1·2·4단계만 해도 충분히 쓸 만하니 음성은 나중에 붙이셔도 됩니다.

📌 piper 는 검색하지 마세요. 먼저 나오는 rhasspy/piper 는 2025년 8월에 문을 닫았습니다. 위 표의 piper1-gpl 이 후속입니다. 📌 옵시디언은 회사 일에 써도 무료입니다. 개인·회사·비영리·학교·공공기관 전부 무료고, 연 $50 상업 라이선스는 후원이지 의무가 아닙니다.


1. 스킬 5개

어디에 넣나

~/.claude/skills/
├── metrics/SKILL.md
├── inbox/SKILL.md
├── trends/SKILL.md
├── plan/SKILL.md
└── vault/SKILL.md

폴더를 만들고 그 안에 SKILL.md 를 넣으면 끝입니다. 클로드 코드를 껐다 켜면 알아서 잡습니다.

📌 이름이 겹치는지 먼저 보세요. ls ~/.claude/skills/ 로 확인하시고, 같은 이름이 있으면 my-metrics 처럼 앞에 뭘 붙이시면 됩니다.

넣고 나서 확인하는 법

처음엔 스킬 이름을 직접 불러 보세요.

metrics 스킬로 지표 정리해줘

클로드가 “어디서 가져올까요?” 하고 되물으면 제대로 잡힌 겁니다. 스킬 안의 ## 소스 가 비어 있어서 묻는 거니까, 거기만 채우시면 그다음부터는 안 묻습니다.

⚠️ 그냥 “지표 뽑아줘” 라고만 하면 안 불려 나올 수 있습니다. 스킬이 많이 깔려 있으면 “지표” 같은 흔한 말은 다른 스킬한테 밀립니다.

이럴 땐 스킬 이름을 말에 넣거나, description 을 내가 실제로 쓰는 말로 바꾸세요. “지표” 대신 “유튜브 구독자”, “인스타 팔로워” 처럼 구체적으로 적으면 훨씬 잘 잡힙니다.

description 이 제일 중요합니다. 클로드는 이 한 줄만 읽고 언제 이 스킬을 꺼낼지 정하니까요.

① metrics — 내 숫자를 모아 옵니다

---
name: metrics
description: 유튜브 구독자·조회수, 인스타 팔로워 등 내 채널 숫자를 모아 표로 정리한다. "구독자 어때", "이번 주 조회수", "metrics 스킬로 지표 정리해줘" 에 쓴다.
---

# 지표 모으기

## 할 일
1. 아래 소스에서 최신 수치를 가져온다.
2. 지난 기록(vault/outputs/metrics/ 의 가장 최근 파일)과 비교한다.
3. 표로 정리하고 vault/outputs/metrics/YYYY-MM-DD.md 로 저장한다.
4. 눈에 띄는 변화를 세 줄로 요약해 소리로 읽어 준다.

## 소스
- 유튜브: (내 채널 주소나 API 키 위치를 여기 적는다)
- 인스타: (위와 같이)
- 그 외: (위와 같이)

## 표 항목
채널 / 지표 / 오늘 / 지난번 / 변화

## 규칙
- 가져온 수치를 그대로 쓴다. 어림잡거나 반올림해서 지어내지 않는다.
- 못 가져온 항목은 "못 가져옴"이라고 적는다. 빈칸을 채우지 않는다.
- 요약은 세 줄을 넘기지 않는다.

② inbox — 아침 브리핑을 만듭니다

---
name: inbox
description: 메일·일정·뉴스레터를 훑어 아침 브리핑을 만든다. "아침 브리핑", "오늘 뭐 있어", "메일 정리해줘" 에 쓴다.
---

# 아침 브리핑

## 할 일
1. 지난 24시간에 온 메일 중 답장이 필요한 것만 고른다.
2. 오늘과 내일 일정을 확인한다.
3. 뉴스레터에서 내 일과 관련된 것만 고른다.
4. vault/outputs/brief/YYYY-MM-DD.md 로 저장하고 소리로 읽어 준다.

## 출력 형식
답장 필요 (세 개까지)
  - 보낸사람 — 한 줄 요약 — 왜 급한지
오늘 일정
  - 시각 — 무엇
읽을 거리 (두 개까지)
  - 제목 — 나한테 왜 의미 있는지

## 규칙
- 광고·알림·영수증은 아예 꺼내지 않는다.
- 답장 필요는 세 개를 넘기지 않는다. 다 중요하면 아무것도 안 중요해진다.
- 소리로 읽을 때는 주소를 읽지 않는다. 파일에만 남긴다.
---
name: trends
description: 내 분야에서 지금 움직이는 주제를 훑어 온다. "요즘 뭐가 뜨지", "트렌드 확인", "소재 좀 찾아줘" 에 쓴다.
---

# 트렌드 훑기

## 할 일
1. 아래 소스에서 최근 48시간에 눈에 띄게 오른 항목을 찾는다.
2. 내 분야(vault/wiki/내-분야.md 참고)와 관련된 것만 남긴다.
3. vault/raw/trends/YYYY-MM-DD.md 에 원문 링크와 함께 저장한다.
4. 다섯 개로 추려 소리로 읽어 준다.

## 소스
- 깃허브 트렌딩
- 해커뉴스 상위
- (내가 보는 커뮤니티나 뉴스레터를 여기 추가)

## 출력 형식
주제 — 무슨 일인지 한 줄 — 왜 지금인지 한 줄 — 링크

## 규칙
- 직접 열어 본 것만 적는다. 못 연 링크는 "확인 못 함"이라고 표시한다.
- 숫자는 본 그대로 적고 어림잡지 않는다.
- 이미 vault/raw/trends/ 에 있는 주제는 "이어짐"으로 표시하고 새 것을 먼저 올린다.

④ plan — 오늘 할 세 가지를 정합니다

---
name: plan
description: 오늘 할 일 세 개를 정해 vault 에 저장한다. "오늘 뭐부터 하지", "오늘 계획", "우선순위 정해줘" 에 쓴다.
---

# 오늘 계획

## 할 일
1. vault/outputs/plan/ 의 어제 파일을 읽어 안 끝난 것을 먼저 본다.
2. 오늘 일정과 겹치지 않게 시간을 잡는다.
3. 딱 세 개를 고른다.
4. vault/outputs/plan/YYYY-MM-DD.md 로 저장하고 소리로 읽어 준다.

## 출력 형식
오늘 (YYYY-MM-DD)
  1. 무엇 — 왜 오늘인지 — 걸릴 시간
  2. ...
  3. ...
미룬 것: 어제 것 중 오늘 안 하는 것과 그 이유

## 규칙
- 세 개를 넘기지 않는다. 네 개가 필요하면 하나를 내일로 미루고 이유를 적는다.
- 끝났는지 아닌지 판단할 수 있게 적는다.
  "리서치하기"는 나쁘고, "레퍼런스 세 개 정리해서 문서로"는 좋다.
- 어제 안 끝난 걸 이유 없이 지우지 않는다.

⑤ vault — 기억을 읽고 씁니다

---
name: vault
description: vault 폴더의 메모를 찾고 정리하고 저장한다. "저장해줘", "그거 뭐였지", "예전에 뭐라고 했지", "정리해줘" 에 쓴다.
---

# vault 읽고 쓰기

## 저장할 때
1. 성격을 판단한다. 날것이면 raw/, 정리된 지식이면 wiki/, 결과물이면 outputs/.
2. 파일명은 YYYY-MM-DD-짧은-제목.md
3. 맨 위에 프론트매터를 넣는다. --- 로 감싸고 date, tags, source 를 적는다.
4. 관련 있는 기존 메모에 위키링크로 잇는다. 링크가 곧 그래프다.

## 찾을 때
1. 파일명, 태그, 본문 순으로 훑는다.
2. 찾은 걸 그대로 인용하고 어느 파일인지 반드시 밝힌다.
3. 없으면 "vault 에 없다"고 말한다. 기억으로 지어내지 않는다.

## 규칙
- 있는 파일을 덮어쓰지 않는다. 고칠 게 있으면 아래에 덧붙이고 날짜를 적는다.
- 없는 파일로 링크를 걸지 않는다. 필요하면 "만들까요" 하고 묻는다.
- 메모 하나에는 주제 하나만 담는다.

2. HUD 프롬프트

클로드 코드를 열고 아래를 그대로 붙여넣으세요.

내 개인 OS 용 어두운 터미널 HUD 를 만들어줘.

한 화면에 다 들어가야 하고, 탭이나 스크롤로 나뉘면 안 돼.

레이아웃 (3단):
- 왼쪽   시스템 상태 — CPU·메모리·디스크, 그리고 오늘 처리한 작업 수
- 가운데 지금 이 순간 — 진행 중인 작업 하나를 크게, 그 아래 오늘 일정
- 오른쪽 명령 목록 — 실행할 수 있는 스킬 이름들, 대기 중인 것 표시

데이터:
- vault/outputs/ 아래 최신 파일들을 읽어서 실시간으로 채운다
- 파일이 바뀌면 새로고침 없이 반영된다
- 데이터가 없는 칸은 비워 두고 "—" 로 표시한다. 가짜 값을 넣지 않는다

음성:
- 스페이스를 누르고 있는 동안 녹음, 떼면 전송
- 녹음 중일 때 화면에 파형이 보인다
- 답이 오면 소리로 읽어 주고, 동시에 가운데 칸에 글자로 남는다

모양:
- 배경은 거의 검정, 글자는 밝은 회색
- 강조는 한 가지 색만 쓴다
- 고정폭 글꼴
- 애니메이션은 최소한으로. 깜빡이는 커서 정도만

한 화면에. 탭 없이. 스크롤 없이.

붙여넣고 나서

돌려서 열어 본 다음, 마음에 안 드는 데를 말로 고치시면 됩니다. “왼쪽 칸이 너무 넓어”, “일정 글씨 키워줘” 이런 식으로요.

한 번에 완성하려고 하지 마세요. 대충 나온 걸 띄워 놓고 쓰면서 고치는 게 훨씬 빠릅니다. 두세 번 돌리면 쓸 만해집니다.


3. vault 구조

vault 를 어디에 두나

옵시디언 보관함 폴더가 그대로 자비스의 기억입니다. 둘을 따로 만들지 마세요.

  1. 옵시디언에서 보관함을 하나 만듭니다. 예를 들면 ~/vault

  2. 클로드 코드를 그 폴더에서 엽니다. cd ~/vault && claude

  3. 그러면 스킬 안의 vault/outputs/... 같은 경로가 그대로 맞아떨어집니다.

⚠️ 다른 폴더에서 클로드 코드를 연 채로 스킬을 쓰면 엉뚱한 곳에 vault/ 를 새로 만들어 버립니다. 보관함 폴더에서 여는 것이 이 구조의 전제입니다.

어디서 열든 같은 곳을 보게 하고 싶으시면, 스킬 안의 vault/ 를 ~/vault/ 로 전부 바꾸시면 됩니다.

폴더

vault/
├── raw/          들어온 것 전부 — 손대지 않은 원본
│   ├── trends/
│   ├── clips/
│   └── notes/
├── wiki/         정리한 지식 — 내가 다시 읽을 것
│   ├── 내-분야.md
│   └── ...
└── outputs/      자비스가 내놓은 것
    ├── brief/
    ├── metrics/
    └── plan/

셋을 나누는 기준

폴더들어가는 것안 들어가는 것
raw/캡처·스크랩·회의록 원문. 손대기 전내가 내린 결론
wiki/여러 번 꺼내 볼 지식. 계속 고쳐 나갑니다한 번 쓰고 마는 메모
outputs/날짜가 붙는 결과물. 덮어쓰지 않고 쌓입니다참고 자료

메모 한 장의 모양

---
date: 2026-08-07
tags: [클로드, 워크플로우]
source: https://...
---

# 제목

## 요점
- 한 줄로 말하면

## 내용
...

## 이어지는 것
[[다른-메모-파일명]]
[[또-다른-메모]]

지킬 건 셋뿐입니다

  1. 결과는 전부 마크다운으로 떨어집니다. 데이터베이스를 안 씁니다. 나중에 도구를 바꿔도 파일은 남습니다.

  2. 메모끼리 링크로 잇습니다. 링크가 쌓이면 그래프가 되고, 자비스는 그 그래프를 뒤져서 답합니다.

  3. 덮어쓰지 않습니다. 고칠 게 있으면 아래에 날짜와 함께 덧붙입니다.

옵시디언에서 그래프 뷰를 켜 보세요. 링크가 늘어날수록 자비스 답이 좋아지는 게 눈에 보입니다.


4. 순서

1단계  스킬 5개를 ~/.claude/skills/ 에 넣고 클로드 코드 껐다 켜기
       → "metrics 스킬로 지표 정리해줘" 해서 반응하는지 확인

2단계  옵시디언 보관함 만들고, 그 폴더에서 클로드 코드 열기
       → vault 스킬로 아무거나 하나 저장해서 옵시디언에 뜨는지 확인

3단계  (선택) whisper.cpp 와 piper 로 음성 붙이기
       → 막히면 건너뛰셔도 됩니다

4단계  위 HUD 프롬프트를 클로드 코드에 붙여넣기
       → 두세 번 돌려서 다듬기

1·2·4단계만 해도 충분히 쓰십니다. 3단계는 여유 있을 때 하세요.


확인한 것 / 못 한 것

직접 해 본 것 (2026년 8월 7일)

  • metrics 템플릿을 넣었더니 클로드 코드가 스킬 목록에 잡았습니다
  • “metrics 스킬로 지표 정리해줘” 하니 제대로 불려 나와 스킬 내용대로 되물었습니다
  • 그냥 “지표 뽑아줘” 는 안 불려 나왔습니다. 그래서 위에 이름을 직접 부르라고 적어 뒀습니다
  • 링크 네 개 전부 열립니다. rhasspy/piper 가 닫힌 것도 여기서 확인했습니다
  • 옵시디언 라이선스 페이지에서 회사 사용도 무료인 걸 확인했습니다

아직 못 한 것

  • 다섯 개를 전부 깔고 하루를 굴려 보지는 않았습니다. metrics 하나만 확인했습니다
  • 템플릿은 뼈대입니다. ## 소스 에 내 채널 주소나 API 키 위치를 채워야 실제로 돌아갑니다
  • HUD 는 한 번에 안 나옵니다. 두세 번 돌린다고 생각하세요
  • 음성 3단계는 컴퓨터마다 다릅니다. 마이크 권한이나 모델 내려받는 데서 막히는 게 흔합니다
  • “몇 분이면 된다”는 말씀은 안 드리겠습니다. 사람마다 다릅니다

낭만빌더 김스듴 · 2026.08.07

FOR TEAMS

이 가이드, 우리 팀에 적용하려면?

회사명과 업무 한 줄만 남겨주시면 널포인터스튜디오가 직접 검토해 회신드립니다.