실행 이력 기반 스킬 업그레이더
실제 실행 로그·검증 실패·사용자 피드백을 근거로 기존 Claude 스킬의 구조적 개선안을 만들고, 명시 승인 후에만 파일을 고치는 메타 스킬입니다.
개발·코딩중급★ 701⑂ 58AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
기존에 쓰던 스킬(SKILL.md)이 자꾸 같은 실수를 하거나, 참조 문서가 낡았거나, 지시가 너무 비대해졌을 때 이를 증거 기반으로 리팩터링해 주는 유지보수 전용 스킬입니다.
- 실행 로그, 테스트/diff, 스크린샷, 사용자 지적 등을 '강한 증거'와 '보강 필요한 약한 증거'로 분류합니다.
- 신호를 프로세스 결함, 검증 누락, 원본 문서 변경, 플랫폼 동작 변경, 라우팅 오류, 내용 비대 등으로 구분합니다.
- 일회성 사고가 영구 규칙이 될 자격이 있는지 '일반화 게이트'로 걸러냅니다.
- 결론을
변경 없음 / 정리·통합 / 부분 리팩터링 / 대규모 리팩터링 / 폐기·교체중 하나로 제시합니다. - 항상 계획만 먼저 내놓고 멈추며, "위 계획 승인"처럼 그 계획을 명확히 가리키는 승인이 있어야 파일을 수정합니다. "그냥 알아서 해"는 승인으로 보지 않습니다.
- 수정 후에는 동봉 검증 스크립트와 py_compile·json.tool 등 최소 기술 점검, 회귀 테스트를 실행하고 결과를 보고합니다.
이런 분께 추천
- 여러 개의 커스텀 스킬을 만들어 운영하며 품질 관리가 필요한 분
- 스킬이 잘못 발동하거나 지시가 길어지기만 하는 문제를 겪는 분
- 팀 내 공용 스킬 저장소를 관리하며 변경 이력과 승인 절차가 필요한 분
활용 예시
- "최근 3번 실행에서 이 배포 스킬이 같은 검증 단계를 계속 빼먹었어. 실행 로그를 근거로 개선안을 만들어줘" → 원인 분류 + 회귀 케이스 포함 계획 제시.
- "공식 API 문서가 v2로 바뀌었는데 우리 스킬은 v1 기준이야" → 원본 변경(source drift)으로 분류해 낡은 안내 삭제·교체 계획 제안.
- "이 스킬 SKILL.md가 800줄로 불어났어" → 중복·낡은 주의사항을 병합·삭제하는 정리 계획을 만들고, 승인 후 반영 및 트리거 회귀 검증.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/dongshuyan/compass-skills/HEAD/skills/run-history-skill-upgrader/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 dongshuyan/compass-skills 의 skills/run-history-skill-upgrader 폴더를 내 ~/.claude/skills/run-history-skill-upgrader/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/dongshuyan/compass-skills.git && mkdir -p ~/.claude/skills && cp -r compass-skills/skills/run-history-skill-upgrader ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널(맥은 터미널, 윈도우는 PowerShell)을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/dongshuyan/compass-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r compass-skills/skills/run-history-skill-upgrader ~/.claude/skills/ references/,scripts/,evals/하위 폴더가 함께 복사됐는지 확인합니다(검증 스크립트가 필요합니다).- Python이 설치돼 있는지 확인합니다:
python3 --version - Claude Code를 다시 시작하고 "이 스킬을 최근 실행 기록을 근거로 개선해줘"처럼 요청합니다.
- 첫 응답은 계획만 나옵니다. 내용을 검토한 뒤 "위 계획을 적용해줘"라고 명확히 승인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT