전사 오류 교정기 (Transcript Fixer)
음성 인식(STT) 결과물의 오탈자·동음이의어·고유명사 오인식을 사전 규칙과 Claude의 자체 AI로 2단계 교정하고, 교정 내용을 개인 사전에 누적 학습시키는 스킬입니다.
유틸리티중급★ 1,339⑂ 214AI 점수 9/10마지막 업데이트: 2026. 8. 16.
무엇을 해주나
- 1단계(사전 교정): SQLite 개인 사전 규칙으로 반복되는 오인식을 즉시·무료로 치환합니다. 기본은 안전 모드로, 위험도가 높은 규칙은 자동 적용하지 않고
*_needs_review.md로 따로 빼둡니다. - 2단계(Claude 내장 AI 교정): API 키 없이 Claude가 원문을 직접 읽어 고유명사, 전문용어, 문맥 의존 동음이의어 등 사전이 못 잡는 오류를 교정합니다. 이 단계가 실제 교정의 핵심입니다.
- 학습·누적: 확정된 교정은
--add로 도메인 사전에 저장되어 다음 파일부터 자동 적용됩니다. 인물 이름은 people roster, 문맥 함정은 도메인 컨텍스트 파일로 관리합니다. - 검토 큐/대시보드: 애매한 항목을 DB에 보관해 승인·수정·원문 유지 등의 판정을 남길 수 있고, 파일이 변경되면 잘못된 자동 수정을 막는 앵커 가드가 작동합니다.
- 안전장치:
--dry-run미리보기,--changes-file변경 리포트,--audit위험 규칙 점검,--report-false-positive오탐 규칙 비활성화,--json기계 판독 상태 출력.
이런 분께 추천
- 회의록·인터뷰·강의 녹취를 자주 정리하는 기획자, 리서처, 콘텐츠 담당자
- Whisper·Otter·회의 툴 자동 자막을 후처리해야 하는 팀
- 제품명/사람 이름이 계속 잘못 표기되어 매번 같은 수정을 반복하는 분
- 전사 정리를 다른 스킬·파이프라인에 연결하려는 자동화 개발자
활용 예시
--init으로 DB를 만든 뒤--input meeting.md --stage 1로 사전 교정을 돌리고, 이어서 Claude가 남은 오류를 직접 읽어 고쳐 최종본을 만듭니다.- 프로젝트 전용 용어집이 쌓인 경우
--domain myproject --apply-domain으로 검수된 규칙 전체를 한 번에 적용해 재실행 없이 마무리합니다. - 교정 중 확인한
클라우드코드 → Claude Code같은 패턴을--add로 저장해 다음 회의록부터 자동 교정되게 합니다. - 여러 녹취 파일은 셸 루프로 일괄 1단계 처리 후, 파일별로 Claude 교정을 이어갑니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-audio/transcript-fixer/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-audio/transcript-fixer 폴더를 내 ~/.claude/skills/transcript-fixer/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/transcript-fixer ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 먼저
uv를 설치합니다(스크립트가 의존성을 자동 설치하는 데 필요). macOS/Linux:curl -LsSf https://astral.sh/uv/install.sh | sh - 저장소를 클론합니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 복사합니다:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/transcript-fixer ~/.claude/skills/ - Claude Code를 재시작하고
/skills등으로transcript-fixer가 목록에 보이는지 확인합니다. - 처음 한 번 DB를 초기화합니다: 스킬 폴더에서
uv run scripts/fix_transcription.py --init - 실제 사용은 Claude Code에 "이 회의록 전사 오류 고쳐줘"처럼 요청하면 됩니다. 안전 모드 때문에
Applied: 0이 나오는 것은 정상이며, 이어지는 Claude AI 교정 단계까지 끝내야 완료입니다. - (선택) Claude Code 없이 CI에서 배치 처리할 때만 GLM API 키(
GLM_API_KEY)를 설정해--stage 3을 사용합니다.
GitHub에서 원본 보기 ↗라이선스: MIT