반복해서 설명하던 걸 스킬로: 내 서류 자동 작성 스킬 만들기와 AI 작업 흐름 점검」
2026.10.13
소개
2주차에는 'AI의 네 가지 속성(다음 토큰 예측, 지식, 작업 기억, 조종 가능성)'과 'Claude Code 스킬'을 배웠습니다. 스킬 강의에서 가장 마음에 남은 문장은 이것이었습니다.
같은 내용을 Claude에게 반복해서 설명하고 있다면, 그것이 바로 스킬로 작성되어야 할 대상이다.
돌아보니 제가 가장 자주 반복하는 설명은 각종 제출 서류에 내 정보를 채우는 일이었습니다. 개인정보 수집·이용 동의서, 강사료·자문료 지급 서류, 이력서, 연구실적 목록, 강사 소개용 약력까지, 서류마다 같은 정보를 매번 다시 알려 주고 있었습니다. 그래서 이번 주에는 세 가지를 해 봤습니다.
내 정보로 서류를 채우는 스킬을 직접 만들기
제가 쓰는 "Claude 계획 → Codex 실행 → Claude 검토" 방식이 서브에이전트와 무엇이 다른지 따져 보기
긴 대화에서 AI가 지침을 잊어버리는 문제를 작업 기억 관점에서 다시 보기
1주차에는 hwp 양식을 맞추는 스킬을 써 봤는데, 이번에는 한 단계 더 나아가 제 업무에 맞춘 스킬을 직접 만들어 봤습니다.
진행 방법
사례 1. 내 정보로 서류를 채우는 스킬 만들기
사용 도구: Claude Code (스킬), 1주차에 쓴 hwpx 편집 스킬
① 정보를 한 파일에 몰지 않고 나눠 담기
강의의 '다중 파일 스킬'과 '점진적 공개' 내용을 그대로 적용했습니다. 핵심 지침은 SKILL.md에만 두고, 정보와 도구는 따로 파일로 분리했습니다. Claude는 SKILL.md를 먼저 읽고, 필요할 때만 나머지 파일을 열어 봅니다.
my-profile-filler/
├── SKILL.md # 핵심 지침과 작업 순서
├── profile.yaml # 이름, 연락처, 소속, 학력, 경력
├── research.yaml # 논문, 저서, 발표, 보고서 (항목마다 날짜 포함)
├── bio/
│ └── short.md # 분량별 약력 (한 줄, 3줄, 문단형, 영문)
├── scripts/
│ ├── research_filter.py # 기간 조건에 맞는 실적만 뽑기
│ └── hwpx_add_signature.py # 한글(HWPX) 문서에 서명 이미지 넣기
└── assets/
└── signature.png # 투명 배경 서명 이미지
(캡처: 내가 만든 스킬의 폴더 구성 화면)
② description에 '언제 쓰는지'를 구체적으로 쓰기
강의에서 Claude는 description을 보고 어떤 스킬을 쓸지 고른다고 했습니다. 그래서 무엇을 하는 스킬인지에 더해, 어떤 말을 하면 작동해야 하는지도 적었습니다. 아래는 개인정보를 빼고 정리한 버전입니다.
---
name: my-profile-filler
description: 내 개인정보(성명·연락처·소속·학력·경력·연구실적·약력)와 서명 이미지로
각종 제출 서류를 채운다. 개인정보 동의서, 강사료/자문료/원고료 지급 서류, 이력서,
연구실적 목록, 채용·위촉 지원서, 강사 소개 약력 요청에 사용.
트리거 — "이 서류 채워줘", "동의서 작성", "서명 넣어줘", "약력 써줘",
.hwpx/.docx/.xlsx/.pdf 양식을 주며 작성을 요청할 때.
---
③ 꼭 지켜야 할 '절대 규칙'을 맨 앞에 두기
개인정보를 다루는 스킬이라 AI가 하면 안 되는 일부터 정했습니다. 사례 3에서 다룰 '중요한 건 맨 앞에' 원칙도 함께 적용했습니다.
## 절대 규칙
1. 주민등록번호, 계좌번호, 은행명은 저장하지 않는다. 지어내지 않는다.
칸이 있으면 비워 두고 사용자에게 직접 입력하라고 알린다.
2. 동의/미동의 체크박스는 임의로 체크하지 않는다. 체크할 칸 목록을 보여 주고 확인받는다.
3. 원본 양식은 덮어쓰지 않는다. 결과는 "<원본이름>_작성"으로 따로 저장한다.
4. 행사일, 금액처럼 서류마다 다른 값은 추측하지 말고 물어본다.
5. "최근 N년 실적" 같은 기간 조건은 반드시 스크립트로 뽑는다. 눈으로 고르지 않는다.
6. 저장된 정보에 없는 항목은 지어내지 말고 물어본다.
④ 실수하기 쉬운 일은 스크립트에 맡기기
채용 지원서나 과제 서류에는 "최근 4년 이내 실적"처럼 기간 조건이 자주 붙습니다. AI가 눈으로 고르면 날짜 경계에서 틀리기 쉽습니다. 그래서 기간 조건을 그대로 넣으면 해당 실적만 뽑아 주는 스크립트를 스킬 안에 넣었습니다.
# 공고문에 날짜가 적혀 있을 때
python3 research_filter.py --from 2022-09-07 --to 2026-09-06
# "기준일로부터 N년"일 때
python3 research_filter.py --years 4 --ref <공고 기준일>
# 논문·저서만 골라 양식에 넣을 데이터로
python3 research_filter.py --years 5 --kinds papers,books --format json
강의에서 "스크립트는 내용을 컨텍스트에 올리지 않고 실행되며, 출력만 토큰을 쓴다"고 했는데, 직접 만들어 보니 정확성 면에서도 이득이 컸습니다. 서명 넣기도 같은 방식으로 스크립트화했고, HWPX 결과는 1주차에 쓴 hwpx 스킬의 검증 도구로 한 번 더 확인하게 했습니다.
⑤ 작업 순서와 보고 방식 정하기
스킬 안에 작업 순서도 적어 두었습니다. 양식 칸 목록 뽑기 → '칸 → 넣을 값' 매핑 표 보여 주기 → 채우기 → 서명 넣기 → 검증 → 보고 순서입니다. 마지막 보고에는 내가 직접 넣어야 할 항목(주민번호, 계좌 등)과 확인이 필요한 항목(날짜, 체크박스, 출처끼리 값이 다른 실적)을 따로 알려 주도록 했습니다.
사례 2. "Claude가 계획하고, Codex가 실행하고, Claude가 검토하는" 방식은 서브에이전트일까?
사용 도구: Claude, Codex
서브에이전트 강의를 듣다가 문득 궁금해졌습니다. 저는 평소에 Claude로 계획을 세우고, 실제 작업은 Codex에게 맡기고, Codex의 결과물을 다시 Claude가 검토하게 하는 방식으로 일합니다. 이것도 서브에이전트와 같은 것인지, 그렇다면 Claude 안에서만 처리하는 편이 나은지 물어봤습니다.
나는 주로 Claude로 계획을 세우고, 실제 작업은 Codex가 하고,
Codex 결과물을 다시 Claude가 검토해서 다음 계획을 이어 가는 방식으로 일해.
이것도 일종의 서브에이전트라고 할 수 있을까?
Claude 안에서 서브에이전트를 불러 작업하는 것과 지금 방식 중 어느 쪽이 나을까?
알게 된 점
구조는 서브에이전트와 같고, 오케스트레이터(지휘자)가 누구냐만 다릅니다. 서브에이전트는 Claude가 자동으로 나눠 맡기고, 제 방식은 제가 직접 결과를 옮기며 지휘하고 있었습니다.
제 방식의 가장 큰 장점은 서로 다른 모델이 교차 검증한다는 점입니다. 같은 모델이 쓰고 검토하면 같은 맹점을 놓칠 수 있습니다. 논문 심사에 외부 심사위원을 두는 것과 같은 이치입니다.
추천은 섞어 쓰기였습니다. 중요한 작업은 지금처럼 교차 검증하고, 파일 정리나 간단한 수정 같은 자잘한 작업은 Claude 서브에이전트로 빠르게 처리합니다.
구분 | Claude + Codex (내 방식) | Claude 서브에이전트만 |
|---|---|---|
검토 품질 | 다른 모델이 보니 맹점이 겹치지 않음 | 같은 모델이라 같은 실수를 놓칠 수 있음 |
수고 | 결과를 직접 옮겨야 해서 번거로움 | 자동이라 편함 |
맥락 | 옮기는 과정에서 일부가 빠질 수 있음 | 같은 폴더·파일을 바로 공유 |
통제 | 단계마다 직접 확인 가능 | 중간 과정이 덜 보임 |
사례 3. 긴 대화에서 지침을 잊어버릴 때, 지침서 md 파일로 해결될까?
사용 도구: Claude
작업 기억 강의에서 "긴 입력의 중간에 묻힌 정보는 잘 보지 못한다"는 내용을 보고, 평소 긴 대화에서 앞서 준 조건을 AI가 무시하던 경험이 떠올랐습니다.
먼저 "지시를 짧게 끊어서 나눠 주면(분할 정복) 해결되지 않을까?"라고 물었습니다 (확인 필요: 원래 질문 문구). 돌아온 답은 "절반은 맞다"였습니다. 큰 작업을 쪼개서 각 단계를 새 대화에서 처리하면 효과가 있습니다. 하지만 한 대화 안에서 지시를 여러 메시지로 잘게 나누면, 앞쪽 지시가 오히려 중간으로 밀려나 무시될 수 있다는 것이었습니다.
그래서 이어서 물었습니다.
그렇다면 중요한 지침을 md 파일에 정리해 두고,
"이 파일을 반드시 참고해라"라는 프롬프트를 넣어 업무를 이어 가는 방식은 어떻게 생각해?
알게 된 점
방향은 맞지만, "매번 읽어라"라고 지시하기보다 자동으로 맨 앞에 들어가는 자리(프로젝트 지침, 스킬)에 두는 편이 더 안정적입니다.
대화 중에 "이 파일 봐"라고 하면 그 내용도 대화가 길어질수록 결국 중간으로 밀려납니다. 중요한 단계에서 "지침서 기준으로 다시 확인해 줘"라고 한 번 더 상기시키거나, 새 대화를 열어야 합니다.
지침서 자체도 길어지면 같은 문제가 생깁니다. 꼭 지킬 것 3~5개를 맨 위에 두고, 배경 설명은 아래로 내리거나 별도 파일로 분리합니다.
정리하면 원칙은 이 한 줄이었습니다.
작업은 쪼개고, 각 조각의 컨텍스트는 깨끗하게, 중요한 건 양 끝에.
결과와 배운 점
배운 점과 나만의 꿀팁
"반복 설명 = 스킬 후보"는 정말 쓸 만한 기준입니다. 스킬로 만들 거리를 찾기 어렵다면, 지난 한 달 동안 AI에게 같은 말을 두 번 이상 한 일을 떠올려 보시길 권합니다.
스킬에는 '할 일'보다 '하면 안 되는 일'을 먼저 쓰세요. 특히 개인정보나 돈이 걸린 서류는 "지어내지 않는다", "임의로 체크하지 않는다"를 맨 앞에 둬야 안심이 됩니다.
AI가 눈으로 판단하면 틀리기 쉬운 일은 스크립트에 맡기세요. 날짜 계산, 기간 필터링 같은 일입니다.
사례 1과 사례 3은 결국 같은 이야기였습니다. 스킬과 프로젝트 지침은 작업 기억의 한계를 보완하려고 존재하는 자리라는 것을 이번 주에 이해했습니다.
다른 모델끼리 서로 검토하게 하는 것도 하나의 전략입니다. 같은 모델의 자기 검토보다 맹점이 덜 겹칩니다.
시행착오
처음에는 정보를 SKILL.md 하나에 다 넣으려고 했습니다 (확인 필요). 강의의 '점진적 공개'를 보고 정보 파일, 스크립트, 이미지를 분리했습니다.
여러 출처에서 모은 실적은 날짜나 권호가 서로 다른 경우가 있었습니다. 그래서 값이 다른 항목은 따로 표시해 제출 전에 확인하도록 했습니다.
도움이 필요한 부분
구형 .hwp 파일은 직접 편집할 수 없어서, 지금은 한글에서 HWPX로 다시 저장해 달라고 안내하는 방식으로 처리하고 있습니다. 더 나은 방법을 아시는 분은 알려 주세요.
앞으로의 계획
Codex를 Claude 쪽에서 직접 호출해, 결과를 복사·붙여넣기로 옮기는 수고를 줄여 볼 생각입니다 (확인 필요: oh-my-claudecode의 Codex 호출 기능 테스트 여부).
실적이 추가될 때 스킬의 실적 파일을 갱신하는 절차도 이미 넣어 두었습니다. 실제로 써 보면서 다듬겠습니다.
도움 받은 글
Anthropic 강의: AI 역량과 한계(네 가지 속성), Claude Code 스킬 강의 (확인 필요: 강의 링크)
2주차 정리 덱: https://claude-week2-deck.vercel.app/ (확인 필요: 공유해도 되는 자료인지)




안녕하세요, 김성훈님. 같은 설명을 반복하고 있다면 스킬 대상이라는 강의 문장을 바로 서류 작성에 적용하신 점이 좋았어요.
주민등록번호·계좌번호는 저장하거나 지어내지 않고, 동의 체크박스는 임의로 체크하지 않으며, 원본은 덮어쓰지 않는 '절대 규칙'을 맨 앞에 두신 설계가 인상 깊었어요. "최근 4년 이내 실적" 같은 기간 조건을 눈으로 고르지 않고 research_filter.py로 뽑게 한 것도 날짜 경계 실수를 막는 좋은 선택이라고 생각했어요.
Claude 계획 → Codex 실행 → Claude 검토 방식을 서브에이전트와 비교해 '지휘자가 누구냐만 다르다, 다른 모델의 교차 검증이 장점'이라고 정리하신 부분도 도움이 됐습니다. 꼬리 살랑살랑, 다음 스킬 후기도 기대할게요 🐈⬛