Claude 스킬이 새 채팅에서 실패할 때: 주간보고 5건으로 평가하기
Claude 스킬이 기대대로 작동하지 않으면 스킬이 실제로 불렸는지와 보고서 내용이 맞는지를 따로 확인하세요. 문장을 더 길게 지시하기 전에, 사용 중인 환경이 그 스킬을 읽을 수 있는지부터 살펴보는 게 좋아요.
이 글의 파일 경로 예시는 로컬 Claude Code 기준이에요. Claude 웹이나 Cowork의 스킬 관리 방법과 섞어 사용하지 마세요. 아래 주간보고 규칙은 가상 업무용 작성 예시이며, 특정 모델에서 성능 개선을 입증한 결과는 아니에요.
1. 같은 파일도 실행 환경에 따라 달라요
Claude Code 공식 스킬 안내에 따르면 개인용 스킬은 ~/.claude/skills/스킬이름/SKILL.md, 프로젝트용은 .claude/skills/스킬이름/SKILL.md에 둘 수 있어요. 개인 폴더에만 둔 스킬을 Cowork나 클라우드 세션이 똑같이 읽는다고 가정하면 안 돼요. 그 환경에서는 계정에 활성화된 스킬 등 별도 로딩 조건을 확인해야 해요.
스킬 이름, 파일명, 시작한 프로젝트 위치를 먼저 확인하세요. 다른 환경에서 성공한 화면을 보고 지침만 계속 고치면 원인을 놓칠 수 있어요.
2. 보고서가 갖춰야 할 칸부터 정해요
보고서 예시를 한 건 먼저 손으로 정리해 보세요. ‘이번 주 진행 내용·확정 결정·다음 행동·확인 필요’ 네 부분이면 시작하기 충분해요. 담당자와 기한이 없는 업무에는 미정이라고 적어요.
다음은 주간보고용 지침을 구성하는 짧은 예시예요. 본인의 업무에 맞게 평가한 뒤 사용하세요. 폴더 이름을 weekly-report로 만들었다면 그 안의 SKILL.md에 넣는 형태예요.
---
name: weekly-report
description: 한국어 업무 메모를 주간보고로 정리할 때 사용한다.
---
# 한국어 주간보고
입력 메모의 사실만 사용한다.
출력 순서: 진행 내용, 확정 결정, 다음 행동, 확인 필요.
다음 행동에는 업무, 담당자, 기한, 근거 메모를 적는다.
담당자나 날짜가 없으면 미정으로 적는다.
제안과 확정 결정을 구분한다.
취소된 업무는 다음 행동에서 빼고 결정 사항에 남긴다.
자료에 없는 수치와 성과를 만들지 않는다.
서로 충돌하는 내용은 확인 필요에 두고 두 근거를 적는다.3. 새 대화에서 두 가지를 따로 시험해요
로컬 Claude Code에서 스킬 이름을 직접 지정해 호출하고, 같은 자료로 결과를 확인하세요. 이어 새 대화에서는 ‘이 메모로 주간보고를 만들어 줘’처럼 자연스럽게 요청해 봐요. 직접 호출은 되지만 자연어 요청에서는 선택되지 않는다면 설명 문구와 호출 조건을 살펴볼 차례예요.
반대로 호출은 확인됐는데 날짜가 틀리면 본문의 작업 규칙이나 입력 자료를 점검해야 해요. ‘스킬을 사용했니?’라는 답변만 믿기보다 제공되는 실행 표시와 실제 산출물을 함께 확인하세요.
4. 평가용 메모 다섯 건을 따로 준비해요
스킬을 만들 때 사용한 예시만 다시 보면 문제를 발견하기 어려워요. 다음과 같은 짧은 가상 메모로 새로 시험해 보세요.
- ‘준호가 11월 6일까지 초안 작성 확정’ → 담당자와 날짜가 그대로 나와야 해요.
- ‘고객 안내문 수정 필요’ → 담당자와 기한은 미정이어야 해요.
- ‘영문판도 만들면 어떨까’ → 확정 결정으로 쓰면 안 돼요.
- ‘지난주 정한 설문은 취소’ → 다음 행동에서 제외돼야 해요.
- ‘A 메모는 금요일, B 메모는 월요일 마감’ → 변경 확정 근거가 없으면 충돌로 남겨야 해요.
각 결과에 ‘호출 확인·사실 누락·임의 날짜·임의 담당자·취소 반영’을 적어요. 스킬이 없는 새 대화와 있는 새 대화에 같은 자료를 주면 무엇이 달라졌는지 비교하기 쉬워요. 좋아진 정도는 실제 결과를 기록한 뒤 판단하세요.
자주 묻는 질문
지침이 길수록 정확해지나요? 길이보다 발견한 오류에 맞는 규칙이 있는지가 중요해요. 담당자 추정이 문제라면 그 조건부터 고치고 같은 평가 자료로 다시 확인하세요.
주간보고를 자동 발송해도 되나요? 작성 규칙과 전송 권한은 별개예요. 처음에는 초안까지만 만들고, 숫자와 수신자를 사람이 확인한 뒤 보내세요.
참고 자료
주제 참고: Ben AI의 Claude Skills 영상. 영상의 팁 목록을 번역하지 않고 자체 한국어 보고 과제로 구성했어요. 기능·경로는 2026년 10월 17일 공식 문서를 확인했어요.