skill.md가 대체 뭐길래 다들 만들고 있을까

Docs to DevRel 시즌2 1편 | 요즘 뜨는 AI 개념 정리

---

안녕하세요! 시즌1에서 8주 동안 프로그래밍 언어부터 DevRel까지 기초를 다졌다면, 시즌2는 완전히 결이 다릅니다. “요즘 뜨는 걸 비전공자가 직접 해봤다”는 콘셉트로, 개발자 커뮤니티에서 매일 쏟아지는 힙한 키워드들을 제 경험을 바탕으로 풀어보겠습니다.

첫 번째 주제는 최근 GitHub이나 개발자 트위터에서 갑자기 자주 보이기 시작한 파일, skill.md입니다.

처음 이 파일명을 봤을 때 솔직한 제 반응은 "또 뭔가 힙해 보이는 네이밍이 유행인가 보다…"였습니다. 그런데 조금 더 들여다보니, 이건 단순한 파일명 트렌드가 아니라 AI와 일하는 방식 자체가 바뀌는 신호더라고요.

---

skill.md란 무엇인가: AI를 위한 업무 인수인계서

결론부터 말하면, skill.md는 AI에게 "내가 일하는 방식"을 알려주는 구체적인 설명서입니다.

회사에 새 팀원이 오면 인수인계를 하잖아요? “우리 팀 회의록은 이런 양식으로 써요”, “이메일 보낼 때는 이런 톤을 써주세요”, "자료 찾을 때는 여기를 먼저 확인하세요"라고요.

skill.md가 바로 그 AI를 위한 인수인계 문서입니다. Claude나 ChatGPT가 내 업무를 도울 때 알아야 할 나만의 규칙, 선호 포맷, 주의사항을 마크다운 형식으로 정리해둔 파일이에요.

실제 예시를 보면:

# 블로그 작성 스킬

## 역할
비전공자를 위한 기술 개념 설명 글 작성

## 톤앤매너
- 해요체 사용
- 과도한 이모지 금지
- 일상적 비유 적극 활용

## 구조
1. 도입: 개인 경험담으로 시작
2. 본문: 3-4개 소제목으로 구성
3. 마무리: 핵심 요약 + 다음 글 예고

---

왜 갑자기 등장했을까: 프롬프트의 한계를 넘어서

AI 초기에는 "사과가 뭐야?"라고 물으면 "사과는 과일입니다"만 해도 신기했죠. 지금은 다릅니다. 우리는 AI에게 훨씬 복잡한 걸 시켜요.

“이 회의록을 팀장님께 보낼 이메일 형식으로 요약해줘.”

이런 지시를 내렸을 때, AI가 일반적인 긴 이메일을 써주면 다시 “좀 더 간결하게”, "불필요한 인사말 빼고"라고 수정 요청을 해야 합니다. 매번 같은 설명을 반복하는 게 번거로워진 거죠.

그래서 사람들이 생각한 게:

“이 파일 하나만 읽으면 내 스타일을 알 수 있게 만들면 안 될까?”

특히 Claude의 ‘프로젝트’ 기능이나 ChatGPT의 ‘나만의 GPT’ 기능이 생기면서, 이런 맥락 파일의 활용도가 폭발적으로 늘어났습니다.

---

일반 프롬프트와 뭐가 다를까

일반 프롬프트 (일회성)

• “오늘 회의록 요약해줘”
• 그때그때 필요한 단발성 심부름

skill.md (지속성)

• “앞으로 내가 주는 모든 회의록은 [결론-액션아이템-세부내용] 순서로 요약해”
• 내 업무 스타일을 규정하는 장기 파트너십

식당에 비유하면, 프롬프트는 "소금 조금만 넣어주세요"라고 매번 주문하는 것이고, skill.md는 단골 식당에 아예 내 입맛 정보를 적어둔 VIP 카드를 걸어두는 것과 같아요.

---

비전공자도 당장 쓸 수 있는 활용법

저도 실제로 써보니까 정말 유용하더라고요. 개발자가 아니어도 충분히 활용할 수 있는 영역들이 많아요.

1. 글쓰기 스킬

• 선호하는 문체와 피해야 할 표현
• 자주 쓰는 구조나 템플릿
• 타겟 독자 설정

2. 리서치 스킬

• 자료 요약할 때 반드시 출처 표기
• 비교 분석할 때는 표 형태로 정리
• 신뢰할 수 있는 정보원 리스트

3. 이메일 커뮤니케이션 스킬

• 내부/외부용 톤의 차이
• 기본 서명 포맷
• 상황별 템플릿

실제로 저는 이 블로그 글을 쓸 때도 "비전공 Technical Writer의 DevRel 준비 관점"이라는 스킬 설정을 Claude에게 미리 알려주고 작업하고 있어요.

---

마무리하며: AI를 도구에서 동료로

skill.md의 핵심 인사이트는 이거예요:

AI를 단순한 검색 도구가 아니라, 내 일하는 방식을 완벽히 이해하는 개인 비서로 업그레이드하는 가장 확실한 방법

"나는 개발자가 아니니까 이런 파일은 필요 없어"라고 생각하셨다면, 오늘 당장 메모장 열고 내가 일할 때 중요하게 생각하는 규칙 3가지만 적어보세요. 그게 바로 여러분의 첫 번째 skill.md입니다.

다음 편에서는 이름이 비슷해서 다들 헷갈려하는 “ChatGPT 에이전트와 내 GPT의 차이”를 속 시원하게 정리해보겠습니다.

읽어주셔서 감사합니다!

---

TAG: #skillmd #AI에이전트스킬 #Claude스킬 #스킬파일 #AI트렌드 #비전공자AI #DocsToDevRel #DevRel준비 #TechnicalWriter