클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

실행 이력 기반 스킬 업그레이더

실제 실행 로그·검증 실패·사용자 피드백을 근거로 기존 Claude 스킬의 구조적 개선안을 만들고, 명시 승인 후에만 파일을 고치는 메타 스킬입니다.

개발·코딩중급70158AI 점수 8/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

기존에 쓰던 스킬(SKILL.md)이 자꾸 같은 실수를 하거나, 참조 문서가 낡았거나, 지시가 너무 비대해졌을 때 이를 증거 기반으로 리팩터링해 주는 유지보수 전용 스킬입니다.

  • 실행 로그, 테스트/diff, 스크린샷, 사용자 지적 등을 '강한 증거'와 '보강 필요한 약한 증거'로 분류합니다.
  • 신호를 프로세스 결함, 검증 누락, 원본 문서 변경, 플랫폼 동작 변경, 라우팅 오류, 내용 비대 등으로 구분합니다.
  • 일회성 사고가 영구 규칙이 될 자격이 있는지 '일반화 게이트'로 걸러냅니다.
  • 결론을 변경 없음 / 정리·통합 / 부분 리팩터링 / 대규모 리팩터링 / 폐기·교체 중 하나로 제시합니다.
  • 항상 계획만 먼저 내놓고 멈추며, "위 계획 승인"처럼 그 계획을 명확히 가리키는 승인이 있어야 파일을 수정합니다. "그냥 알아서 해"는 승인으로 보지 않습니다.
  • 수정 후에는 동봉 검증 스크립트와 py_compile·json.tool 등 최소 기술 점검, 회귀 테스트를 실행하고 결과를 보고합니다.

이런 분께 추천

  • 여러 개의 커스텀 스킬을 만들어 운영하며 품질 관리가 필요한 분
  • 스킬이 잘못 발동하거나 지시가 길어지기만 하는 문제를 겪는 분
  • 팀 내 공용 스킬 저장소를 관리하며 변경 이력과 승인 절차가 필요한 분

활용 예시

  1. "최근 3번 실행에서 이 배포 스킬이 같은 검증 단계를 계속 빼먹었어. 실행 로그를 근거로 개선안을 만들어줘" → 원인 분류 + 회귀 케이스 포함 계획 제시.
  2. "공식 API 문서가 v2로 바뀌었는데 우리 스킬은 v1 기준이야" → 원본 변경(source drift)으로 분류해 낡은 안내 삭제·교체 계획 제안.
  3. "이 스킬 SKILL.md가 800줄로 불어났어" → 중복·낡은 주의사항을 병합·삭제하는 정리 계획을 만들고, 승인 후 반영 및 트리거 회귀 검증.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/dongshuyan/compass-skills/HEAD/skills/run-history-skill-upgrader/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널(맥은 터미널, 윈도우는 PowerShell)을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/dongshuyan/compass-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r compass-skills/skills/run-history-skill-upgrader ~/.claude/skills/
  5. references/, scripts/, evals/ 하위 폴더가 함께 복사됐는지 확인합니다(검증 스크립트가 필요합니다).
  6. Python이 설치돼 있는지 확인합니다: python3 --version
  7. Claude Code를 다시 시작하고 "이 스킬을 최근 실행 기록을 근거로 개선해줘"처럼 요청합니다.
  8. 첫 응답은 계획만 나옵니다. 내용을 검토한 뒤 "위 계획을 적용해줘"라고 명확히 승인하세요.