# 링크 하나에서 시작해, 내 설명 방식을 AI의 재사용 워크플로로 만든 방법
2026.07.25

## 📝 한줄 요약
기술 문서를 볼 때마다 "초심자도 이해하게 풀어달라"고 반복 요청하던 방식을, 공식 원문 확인·정확한 비유·주의점까지 포함하는 개인 AI 스킬 ‘링크설명’으로 만들었다.
## 🎯 이런 분들께 도움돼요
- 기술 문서가 어렵지만 AI에게 매번 같은 설명 방식을 요청하는 분
- AI 답변의 비유가 그럴듯하지만 정확한지 불안한 분
- 내 업무 방식이나 글쓰기 방식을 AI와 함께 재사용 가능한 절차로 만들고 싶은 분
- AI와 한 작업을 나중에 사례글로 남기고 싶은 분
## 😫 문제 상황 (Before)
새 도구나 기술 문서를 볼 때마다 내용은 흥미로웠지만, 처음 접하는 사람의 눈에는 용어가 너무 많았다.
"쉽게 설명해줘"라고 하면 요약은 받을 수 있다. 하지만 다음 요청에서는 다시 같은 말을 덧붙여야 했다.
- 비유도 넣어줘
- 어려운 용어는 풀어줘
- 실제로 어떻게 작동하는지도 알려줘
- 비유가 어디까지 맞는지 말해줘
- 처음이라면 무엇부터 하면 되는지 알려줘
그때마다 AI에게 설명 방식을 다시 조율하는 건 작은 일이지만, 반복될수록 흐름을 끊었다. 그래서 질문 하나에 답을 받는 대신, 앞으로도 반복해 쓸 수 있는 설명 방식 자체를 만들기로 했다.
> 기술 문서를 보며 "이게 무슨 뜻이지?"라고 느끼는 장면, 또는 여러 번 비슷한 설명 요청을 하는 채팅 화면을 개인정보 없이 캡처한다.
## 🛠️ 사용한 도구
- Hermes Agent: 개인 스킬을 만들고, 스킬의 실제 동작과 설치 상태를 확인하는 데 사용
- Tailscale 공식 문서: 초심자용 설명 방식을 시험할 실제 기술 문서로 사용
- GitHub의 daht-mad/write-post: AI 작업 기록을 DEVLOG와 사례글로 정리하는 워크플로 참고 및 설치
## 🔧 작업 과정
### 1. "설명"이 아니라 "설명 방식"을 요청했다
처음 요청은 단순했다.
> 링크를 주면 초심자 대상 이해하기 쉽게, 비유를 포함해서 설명해 주는 스킬을 만들 수 있어?
여기서 핵심은 특정 문서의 요약이 아니었다. 링크가 바뀌어도 재사용할 수 있는 판단 기준과 답변 구조가 필요했다.
그래서 스킬에는 다음 순서를 넣었다.
1. 사용자가 준 링크의 원문을 먼저 확인한다.
2. 문서 색인이라면 시작하기·핵심 개념·사용 방법 등 필요한 하위 문서를 추가로 확인한다.
3. 내용을 무엇인가 → 왜 쓰나 → 어떻게 작동하나 → 무엇을 조심해야 하나 순서로 설명한다.
4. 비유는 이해를 돕는 도구로만 쓰고, 실제 기술적 작동과 한계를 분리해서 적는다.
5. 확인한 공식 출처와 초심자가 해볼 다음 행동을 남긴다.
이렇게 바꾸니 "쉽게 설명해줘"라는 감각적인 요청이, 확인 가능한 작업 절차가 됐다.
### 2. Tailscale 문서로 비유의 정확성을 시험했다
테스트 대상으로는 Tailscale 공식 문서를 사용했다. Tailscale은 떨어져 있는 기기와 서비스를 안전하게 연결하는 도구라서, 네트워크 용어를 처음 접하는 사람에게는 낯설 수 있다.
설명에는 이런 비유를 사용했다.
비유: 각 기기에 직원 출입증을 발급하고, 승인된 기기끼리만 다니는 사설 통로를 만든다고 생각하면 된다.
하지만 비유만으로 끝내지 않았다.
실제로는: 계정 인증, 기기 상태, 접근 정책이 각각 접속 가능 범위에 영향을 준다.
비유의 한계: 출입증을 받았다고 해서 모든 기기나 서비스에 자동으로 접근할 수 있는 것은 아니다.
이 구분이 중요했다. 보안이나 네트워크 주제에서 "안전하다"는 말만 반복하면 오히려 오해가 생길 수 있기 때문이다.

>
> 스킬의 구조가 보이는 화면 또는 비유 / 실제로는 / 비유의 한계 형식으로 정리된 예시 화면을 캡처한다. 개인 파일 경로나 계정 정보는 가린다.
### 3. 만든 스킬이 실제로 쓰일 수 있는지 확인했다
스킬을 만들었다고 해서 끝이 아니었다. 실제로 로컬에 등록돼 있고 사용 가능한지 확인했다.
확인 결과, 링크 설명 스킬은 로컬 스킬로 등록돼 활성화된 상태였다.
여기서 알게 된 점은 간단하다.
- 스킬은 자동으로 실행되는 앱이 아니다.
- 스킬은 AI가 작업 중 불러와 따르는 작업 지침서다.
- 즉, "링크설명"이라고 요청하면 AI가 원문 확인부터 출처 제시까지 정해 둔 흐름을 따르게 하는 장치다.
나는 이 워크플로를 편하게 부를 이름으로 ‘링크설명’을 정했다. 내부의 정식 스킬명과 별개로, 내가 자연어로 부르는 호출명이 생긴 셈이다.
### 4. 작업 기록을 사례글로 남기는 흐름도 함께 만들었다
스킬을 만든 뒤에는 나중에 "무엇을 어떻게 했더라?"를 다시 찾지 않도록 write-post 워크플로도 설치했다.
이 도구는 AI 코딩 도구의 작업 기록을 먼저 DEVLOG로 모으고, 검토를 거쳐 비개발자도 읽기 쉬운 사례글 초안으로 바꾸는 흐름을 제공한다.
중요한 원칙은 두 가지였다.
- 대화 내용을 통째로 복사하지 않는다.
- 확인된 실행과 결과만 근거로 남긴다.
덕분에 이번 글도 기억에 의존해 꾸미는 대신, 실제 요청·문서 확인·스킬 생성·설치 검증이라는 근거를 바탕으로 정리할 수 있었다.

>
> 링크설명 요청 뒤에 초심자용 구조로 정리된 답변, 또는 write-post가 설치된 도구 목록을 보여 주는 화면을 캡처한다.
## ✅ 결과 (After)
### Before vs After
| 항목 | Before | After |
|---|---|---|
| 링크 설명 요청 | 매번 원하는 말투·비유·주의점을 다시 설명 | 링크설명이라는 짧은 요청으로 같은 원칙 적용 |
| 기술 문서 이해 | 요약은 받지만 실제 작동이나 한계가 빠질 수 있음 | 원문·하위 문서 확인, 실제 작동, 비유의 한계까지 포함 |
| 비유 사용 | 이해는 쉽지만 사실과 섞일 위험 | 비유 → 실제로는 → 비유의 한계로 분리 |
| 작업 기록 | 나중에 대화를 다시 찾아야 함 | DEVLOG를 먼저 만들고 사례글로 전환 |
이번 결과는 거창한 자동화 하나가 아니라, 내가 자주 하는 요청을 AI가 일관되게 처리하도록 만든 작은 개인 시스템이다.
## 💬 배운 AI 활용 팁
### 1. 반복 요청은 "프롬프트"가 아니라 "절차"로 바꿔볼 수 있다
AI에게 좋은 답변을 한 번 받는 것과, 다음에도 비슷한 품질로 답받는 것은 다르다. 후자가 필요하다면 원하는 답변의 형식을 스킬이나 체크리스트로 분리하는 편이 좋다.
### 2. 비유는 반드시 실제 설명과 한 세트로 쓴다
특히 보안·네트워크·재무처럼 오해의 비용이 큰 주제는 비유만 매끄러우면 위험하다. 비유 다음에 "실제로는 무엇이 일어나는가"와 "어디까지가 비유인가"를 붙이면 설명의 품질이 달라진다.
### 3. 결과보다 근거를 먼저 남긴다
사례글은 멋진 성공담보다 재현 가능한 기록이 오래 남는다. 실제로 확인한 문서, 파일, 설치 결과, 막힌 지점만 남기면 과장 없이도 충분히 도움이 되는 글이 된다.
로그인하고 댓글을 남겨 주세요
‘쉽게 설명해줘’를 링크가 바뀌어도 반복할 수 있는 다섯 단계 절차로 바꾸고, Tailscale 설명에서 직원 출입증 비유 뒤에 계정 인증·기기 상태·접근 정책과 비유의 한계를 분리한 점이 좋았어요. 이해하기 쉬운 설명과 기술적 정확성을 함께 지키려는 기준이 또렷하게 보입니다.
스킬 생성에 그치지 않고 로컬 등록과 활성 상태를 확인하고, 확인된 실행만 DEVLOG와 사례글로 남기는 흐름까지 연결하신 점도 재사용성을 높여요. 다른 종류의 기술 문서에서도 같은 구조가 유지되는지 몇 번 더 확인되면, 이 설명 방식이 어디까지 잘 일반화되는지도 더 선명해질 것 같아요.
단순히 쉽게 설명해달라는 프롬프트를 반복하는 대신, 설명 방식을 스킬로 만든 접근이 인상적이었습니다. 특히 비유와 실제 동작, 비유의 한계를 함께 설명하도록 만든 부분은 다른 기술 문서를 볼 때도 그대로 활용하기 좋은 방식인 것 같네요.
대화 내용을 통째로 옮기지 않고 확인된 실행과 결과만 DEVLOG에 남긴 뒤 사례글로 전환한 흐름이 특히 꼼꼼하네요. 실제 요청·공식 문서 확인·스킬 생성·설치 검증을 근거로 글을 구성해, 성공담보다 재현 가능한 작업 기록의 가치가 선명하게 드러났습니다. 스킬을 만드는 데서 그치지 않고 작업 과정 자체를 다시 활용할 수 있는 자산으로 남기신 점이 인상적입니다.



나만의 스킬과 나만의 체크리스트를 만들 수 있겟네 라는 생각이 든 글이었습니다 !!