finance-ai-skills

한국 회계사 · 세무사 · 재무팀이 Claude Code 와 Claude 데스크톱 앱에서 쓰는 재무 · 회계 · 세무 · 감사 실무 스킬 모음입니다. MIT 라이선스 오픈소스로 공개하고, 하나씩 추가합니다.

법인세 신고 검토(경정청구 후보), 통합고용세액공제, 부가세 신고서 검토, 양도소득세 예정신고서, 급여대장 · 원천세 전자신고, 세법 · 회계기준 자문 회신, 현금흐름표(직접법 · 간접법), 증권계좌 거래내역 전표(국내 · 미국 주식), 리스회계(K-IFRS 1116), 월 결산과 더존 업로드, 자금일보, 외부감사 분개 테스트(JET), DART 감사보고서 DSD 푸팅 · 변환을 다룹니다. 일반기업회계기준과 K-IFRS, 국세청 · 법제처 서식 기준입니다.

Claude Code skills for Korean accounting, tax and audit work: corporate tax return review, VAT return review, capital gains tax filing, payroll and withholding tax e-filing, cash flow statements, brokerage account journal entries (Korean and US stocks), K-IFRS 16 leases, month-end close, journal entry testing (JET) and DART audit report footing. Documents and answers are in Korean.

실무에서 매달 쓰는 것을 공개합니다. 공통 원칙은 세 가지입니다. 계산은 결정적인 코드가 하고, 판단 근거는 원문으로 남기고, 결과는 AI 와 무관한 방법으로 한 번 더 검산합니다.

세무 · 회계 · 감사 · 커리어 가운데 쓰는 분야만 골라 받을 수 있습니다(설치).

AI면접점검

재무·회계 면접에서 AI 활용을 어떻게 말할지 준비하는 스킬입니다. 면접관 역할로 질문하고, 답을 네 항목의 1~4점 기준으로 채점하고, 비어 있는 것을 채우게 돕습니다. 네 항목은 맥락 설정력, 분해력, 검증력, 지속력이고 Anthropic의 AI Fluency 4D를 재무에 맞게 옮긴 것입니다.

• 스킬 없이도 됩니다. AI대화가이드에 일반 대화창에 붙여 넣을 문장이 있습니다.
• 문서 셋. 대비체크리스트는 항목별 질문과 준비 목록, 채점기준은 1~4점 기준입니다.
• 회사 내부 자료는 넣지 않습니다. 전 직장 자료는 숫자와 이름을 지우고 방식만 설명합니다.

결산자동화

결산 스킬을 만들 때 참고하는 예시입니다. 그대로 쓰지 말고 회사 업무처리에 맞게 고쳐 쓰십시오. 계정체계, 거래처코드, 전표 기준, 부가세 판단, 회계 프로그램 양식은 회사와 사무소마다 다릅니다. 강의에서는 수강생이 결산 스킬을 처음부터 직접 만든 뒤, 같은 자료로 이 스킬을 돌려 결과를 비교하고 빠뜨린 처리를 찾는 데 씁니다.

• 원천 열 개. 통장 · 카드 승인 · 세금계산서 · 급여대장 · 거래처 · 계정과목 · 기초 재무상태표 · 전기 분개장 · 플랫폼 정산서 · 수출 인보이스.
• 산출 네 가지. 결산확정 워크북(분개장 · 시산표 · 재무제표 · 현금흐름표, 전부 수식), 더존 일반전표 · 매입매출전표 업로드 파일, 전문가 확인사항(.docx).
• 규칙에 안 맞는 거래는 분개하지 않습니다. 가계정에 두고 미분류 목록으로 냅니다. 공제 · 불공제, 계정 분류, 기말재고 같은 판단은 확인사항으로 남기고 전문가가 확정합니다.
• 검증. 더존 업로드 사전검증(양식 · 거래처코드 · 사업자번호 · 차대)과 워크북 재계산 검산(대차 · 현금 · 순이익 연결)을 통과해야 끝납니다.

python ~/.claude/skills/결산자동화/scripts/run_close.py <원천폴더> <산출폴더> 2026Q2 profile_sample

프로파일 예시는 scripts/profile_sample.py 입니다. 자기 회사에 쓰려면 그 파일을 복사해 계정 · 거래처 · 판단 기준을 바꿉니다. 더존 SmartA 양식에서만 확인했고, 위하고 · 이카운트 등 다른 프로그램 양식은 다루지 않습니다.

현금흐름표

분개장의 현금 전표를 전부 보고 상대계정으로 영업·투자·재무를 정합니다. 미지급금·가지급금·가수금처럼 상대계정만으로 모르는 것은 원천 전표, 은행 상세 내역, 적요로 따라가 발라냅니다. 그 결과로 직접법을 만들고, 감사인 정산표(WTB) 방식의 간접법과 맞춰 봅니다.

• 계산은 엔진, 워크북은 수식. 분개장 줄마다 활동·항목이 붙고 직접법·정산표·간접법은 전부 그 열을 SUMIFS 합니다. 분개장 한 줄의 분류를 고치면 현금흐름표가 따라 바뀝니다.
• 직접법과 간접법이 맞는 것은 분류가 맞다는 증거가 아닙니다. 둘이 같은 분류를 쓰기 때문입니다. 그래서 분류와 무관한 사실로 분류를 확인하는 독립 검산을 따로 둡니다.
• 읽는 입력. 한 줄 한 계정 분개장, 차변·대변 계정이 다른 열인 분개장, 더존 계정별원장, 합계잔액시산표, 공시 양식 재무상태표·손익계산서, 은행 상세 내역, 계정명세서.
• 기준. 일반기업회계기준(중소기업 포함)과 K-IFRS.

실제 장부 네 벌로 돌려 내부 대사와 독립 검산을 통과했고, 그중 하나는 감사인 정산표와 대조했습니다. 다만 더존·이카운트류 양식에서만 검증했고, 연결 현금흐름표와 여러 해 비교 표시는 다루지 않습니다.

설치

스킬 전체를 받거나 분야 하나만 받습니다. 받은 스킬이 많으면 Claude 가 요청과 맞지 않는 스킬을 고르는 일이 생기니, 쓰는 분야만 받는 편이 낫습니다.

설치 스크립트는 스킬을 스킬 폴더에 넣고 파이썬 패키지까지 설치합니다.

윈도우 PowerShell, 전체

irm https://raw.githubusercontent.com/hany202507/finance-ai-skills/main/install.ps1 | iex

윈도우 PowerShell, 분야 하나(예: 감사)

$env:FAS_PLUGIN = 'audit'; irm https://raw.githubusercontent.com/hany202507/finance-ai-skills/main/install.ps1 | iex

FAS_PLUGIN 은 그 PowerShell 창을 닫을 때까지 남습니다. 같은 창에서 전체를 다시 받으려면 Remove-Item Env:FAS_PLUGIN 을 먼저 실행합니다.

맥 · 리눅스 터미널, 전체

curl -fsSL https://raw.githubusercontent.com/hany202507/finance-ai-skills/main/install.sh | sh

맥 · 리눅스 터미널, 분야 하나(예: 감사)

curl -fsSL https://raw.githubusercontent.com/hany202507/finance-ai-skills/main/install.sh | sh -s -- audit

분야 하나만 받을 때는 파이썬 3.10 이상이 있어야 합니다(설치 스크립트가 파이썬으로 분야 목록을 읽습니다). 감사 · 커리어는 법령 서버와 세법 훅을 설치하지 않습니다.

Claude Code 플러그인으로 받아도 됩니다. 플러그인으로 받으면 파이썬 패키지와 법령 서버는 설치되지 않으니, 스킬 폴더의 requirements.txt 를 따로 설치하고 법령 서버는 아래 「법령 서버는 한 번만 등록합니다」 순서대로 등록합니다. 전체(finance-ai-skills)와 분야 플러그인을 함께 설치하면 같은 스킬이 두 번 보이니 하나만 설치합니다. 아래는 감사 분야를 받는 예이고, 전체는 마지막 줄의 audit 을 finance-ai-skills 로 바꿉니다.

/plugin marketplace add hany202507/finance-ai-skills
/plugin install audit@finance-ai-skills

~/.claude/skills/ 아래에 스킬 폴더가 들어가고, 법령 조회 서버는 ~/.claude/mcp/korean-law 에, 세법 훅은 ~/.claude/hooks/tax-source-guard.mjs 에 들어갑니다. Claude Code 를 다시 열면 잡힙니다. 회계·세무 스킬은 파이썬 3.10 이상, 법령 서버는 Node.js 18 이상이 필요합니다. 새 판이 나오면 같은 줄을 다시 실행하면 덮어씁니다.

양도소득세는 TaxDoctor 커넥터 하나면 됩니다. 세액 계산은 스킬에 든 기준정보(rules/)로 하고 법령 서버를 부르지 않습니다. TaxDoctor 는 근거 조문을 더 찾을 때 씁니다. 세법 90개와 세법이 아닌 참조 법령 81개(민법 · 주택법 · 건축법 등), 지난 판, 부칙, 조정대상지역 공고 이력이 들어 있습니다. korean-law 법령 서버 · 법제처 OC · 법제처 통합검색은 양도소득세에서는 TaxDoctor 가 안 될 때 쓰는 선택 항목입니다.

세법자문-회신 · 법령검토 스킬은 TaxDoctor 커넥터, korean-law 법령 서버, 법제처 OC(OPEN API 인증값), 법제처 통합검색 커넥터 네 가지로 법령 원문을 읽습니다. 설치 스크립트는 끝에 「법령 서버 점검」을 띄워, 없는 것만 설치 경로와 주소를 붙여 알려 줍니다. TaxDoctor 와 법제처 통합검색은 Claude 앱 커넥터라 스크립트가 볼 수 없습니다. 터미널로 등록한 경우가 아니면 늘 [확인] 으로 나옵니다.

Claude 앱에 「hany202507/finance-ai-skills 의 스킬을 설치해 줘」라고 보내 설치해도 됩니다. 스킬을 하나만 골라 설치할 수도 있습니다. 설치를 마치면 Claude 가 이 대화에서 TaxDoctor(search_tax) · korean-law(get_law_text) · 법제처 통합검색(legal_research) 도구가 보이는지 확인하고, 없는 것만 아래 순서로 안내합니다. 양도소득세만 설치했으면 TaxDoctor 만 확인하고, 나머지 셋은 선택 항목이 있다는 것만 알립니다. 같은 내용을 양도소득세 SKILL.md 「설치 뒤 점검」 절과 세법자문-회신 · 법령검토 SKILL.md 「준비」 절에도 적었습니다.

법령 서버는 한 번만 등록합니다. TaxDoctor 부터 넣습니다.

TaxDoctor 에 무료 가입하고 Claude 설정 → 커넥터 → 커스텀 커넥터 추가에 https://mcp.taxdoctorai.com/mcp 를 넣습니다. 세 스킬이 모두 씁니다. 세법자문-회신은 세법 조사를 TaxDoctor 로 하고, 법령검토는 세법 조문을 TaxDoctor 와 한 번 더 대조합니다.

세법자문-회신 · 법령검토를 쓰면 korean-law 법령 서버도 등록합니다. 양도소득세만 쓰면 건너뛰어도 됩니다.

1. 법제처 OPEN API 인증값(OC)을 받습니다. open.law.go.kr 에 회원가입하고 「OPEN API 신청」에서 활용신청을 합니다(승인 1~2일). OC 는 가입 아이디입니다(이메일이 [email protected] 이면 hong).
2. 신청 화면에서 법령 본문·부칙, 행정규칙, 판례·법령해석례·헌재결정례, 별표·서식, 조세심판원 결정례를 모두 체크합니다. 좁게 신청하면 오류 없이 0건이 나옵니다.
3. IP 칸이 있으면 쓰는 PC 의 공인 IP 를 넣습니다. 2026-07 법제처 답변으로는 아이디로 호출한다고 하니 신청 화면 안내를 따릅니다. 문의는 02-2109-6446 입니다.
4. 아래 명령으로 등록합니다.

claude mcp add -s user korean-law -e LAW_OC=<본인OC> -- node "<홈 폴더 절대경로>/.claude/mcp/korean-law/index.js"

경로는 절대경로로 적습니다. ~ 를 쓰면 연결이 안 됩니다. 데스크톱 앱만 써서 claude 명령이 없으면 홈 폴더의 .claude.json 파일 mcpServers 에 같은 내용을 넣습니다. 적는 꼴은 세법자문-회신 스킬의 「준비」 절에 있습니다.

법령검토 스킬로 노무·상법을 볼 때는 고용노동부 행정해석과 판례 본문 검색을 법제처 통합검색 커넥터로 합니다. 커스텀 커넥터 추가에 https://mcp.gomdori.app/law?oc=<본인OC> 를 넣습니다(korean-law-mcp, korean-law 서버와 같은 OC). ?oc= 를 빼면 키 없는 사용자가 함께 쓰는 한도에 걸려 요청이 자주 막힙니다.

등록한 뒤 앱을 껐다 켜고 「소득세법 제89조 원문 찾아줘」를 보냅니다. 법령명 · 시행일 · 링크가 나오면 TaxDoctor 가 연결된 것입니다. korean-law 는 「korean-law 로 민법 제162조 원문 찾아줘」를 보내 law.go.kr 링크가 나오면 연결된 것입니다.

세법 훅 (tax hook)

세법 낱말이 든 질문에 근거 규약(출처 범위와 등급)을 끼워 넣는 훅입니다. 스킬이 뜨지 않은 질문에도 규약이 적용됩니다. ~/.claude/settings.json 에 한 번 등록합니다.

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [ { "type": "command", "command": "node \"<홈 폴더 절대경로>/.claude/hooks/tax-source-guard.mjs\"" } ] }
    ]
  }
}

node "<홈 폴더 절대경로>/.claude/hooks/tax-source-guard.mjs" --selftest 가 PASS 를 내면 정상입니다.

플러그인으로 설치하려면 /plugin marketplace add hany202507/finance-ai-skills 후 /plugin install finance-ai-skills@finance-ai-skills.

세법자문-회신

세무 쟁점 하나를 받아 답변 md 파일(세법자문_{주제}.md)을 만듭니다. 세무 자문에서 잘 나는 사고는 틀린 결론보다 빠진 논점입니다. 부가세 서식 미제출 건에서 조세특례제한법에 있는 가산세를 통째로 놓친 일이 이 스킬의 출발점입니다.

• 근거 출처는 둘. 세법은 TaxDoctor 로 조사하고 법제처 korean-law 원문과 대조합니다. 세법이 아닌 참조 법령(상법 · 민법 · 건축법 등), 부칙의 적용 시점, 지난 과세기간 조문도 TaxDoctor 로 읽고 korean-law 원문과 대조합니다. TaxDoctor 에 없는 법령(최저임금법 · 시행규칙 등)은 korean-law 로 엽니다. 웹과 기억은 근거로 적지 않습니다.
• 근거마다 등급. ★★★ 은 원문을 확인한 것입니다. 현행 세법 조문은 두 곳에서 시행일이 같은 판을 대조합니다. 한 곳에서만 읽었으면 ★★☆ 입니다.
• 검토 순서. 실체 · 절차 · 가산세 · 감면 · 기간. 가산세와 감면은 의무 위반이 있거나 가산세를 물을 때만 훑습니다. 훑을 때는 국세기본법 · 조세특례제한법 · 국세징수법을 세목과 상관없이 넣고, 법인세법 · 소득세법에 따른 가산세에는 지방소득세 가산세를 같이 적습니다.
• 적용 시점은 부칙에서. 과세기간 중 인용한 항 · 호가 바뀌었으면 부칙의 적용례 · 경과조치를 원문으로 확인합니다.
• 답변 목차는 넷. 결론 · 쟁점분석 · 실무해설 · 근거규정 순서이고, 대화창 완료 보고도 같은 순서입니다. 근거규정에는 결론을 직접 정하는 조문만 한 줄씩 싣습니다(질문 하나에 세 줄, 전체 다섯 줄 이내). 결론이나 금액을 바꿀 수 있는데 정하지 못한 것만 「확인할 사항」으로 따로 적습니다.
• 저장 전 인용 확인. 답변에 적은 번호는 실제로 있는지 확인하고, 근거 조문은 초안을 보지 않은 서브에이전트가 원문과 대조합니다.
• 발송용은 따로. 고객에게 보낼 때만 등급과 검토 기록을 뺀 같은 목차의 회신 문서를 만듭니다. 메일은 초안까지만 만듭니다.

준비물은 셋입니다. TaxDoctor 커넥터, 이 저장소의 mcp/korean-law 법령 서버(본인 OC 필요), 세법 훅. 붙이는 방법은 스킬의 「준비」 절에 있습니다. 2026-10-12 에 해석 질의, 상법이 걸린 배당 질의, 가산세 질의 세 건으로 시험했습니다. 2026-10-20 에 답변 목차를 바꾸고 회식비 매입세액, 업무용승용차 리스 두 건으로 다시 시험했습니다.

양도소득세

사용자에게는 계약일·잔금일·등기접수일과 읍면동 주소, 세대가 가진 주택 목록을 묻고, 조정대상지역 여부·보유햇수·세율은 엔진이 판정합니다. 조정대상지역·투기과열지구·투기지역은 2017-08-03 부터의 지정·해제 공고 35건을 기준일마다 다시 적용해 정합니다.

세율·공제율·기준금액·처분기한·한시배제 양도기한은 판정·계산 코드가 규칙세트에서 읽습니다. 코드에 남은 고정 날짜와 햇수 몇 개는 근거와 함께 skills/양도소득세/references/규칙세트_스키마.md 의 「코드에 남은 고정값」에 적었습니다. rules/추출규칙.json 에는 사람이 확인한 값을 적습니다. scripts/build_ruleset.py 는 그 값의 원문 발췌를 2025-01-01 이후 시행된 법제처 조문 버전마다 본문과 글자 그대로 대조해 규칙세트를 만듭니다. 현행 버전은 TaxDoctor 와 한 번 더 대조합니다.

• 코드값. 결과의 세율구분·자산종류·과세구분·취득가액종류는 국세청 양도소득세 파일설명서 V5.17 의 코드입니다. 신고서에는 서식 표기로 바꿔 적습니다.
• 합산. 같은 해 둘 이상 양도하면 산출세액은 같은 세율 자산 합산 세액과 합산 비교세액 중 큰 값입니다(소득세법 제104조⑤). 계산근거 엑셀에 두 금액이 모두 나옵니다.
• 검산. 장특공률과 고가주택 안분은 조문 식으로 직접 계산하고, 세율은 과세표준을 늘려 본 세액 증가분으로, 워크북은 수식 재계산으로 엔진 값과 대조합니다. 하나라도 어긋나면 종료코드 1 로 끝납니다.
• 기준정보 확인일. 규칙세트는 확인일 시점의 법령 기준입니다. 7일이 지나면 모든 결과에 갱신하라는 경고가 붙습니다. 지금은 scripts/refresh/fetch_articles.py 로 다시 받습니다.
• 형식이 틀린 값과 반영하지 못하는 사실. 예/아니오 문항에 글자를 넣는 것처럼 형식이 틀린 값은 그 문항을 다시 묻습니다. 엔진이 반영하지 못하는 사실(같은 날 주택 여러 채 양도, 매수인이 부담한 양도소득세, 특수관계인에게 시가보다 낮게 양도 등)이 있으면 다루지않음으로 알립니다.
• 중과 한시배제. 보유 2년 이상 주택이면 가목(2026-05-09 까지 양도)과 함께 2026-04-23 신설된 나목(토지거래허가 대상)·다목(2026-05-09 까지 계약·계약금 수령)도 판정합니다. 양도 기한이 계약일부터 4개월인지 6개월(서울 21개 구·경기 12곳)인지는 규칙세트의 지역표로 정합니다. 토지거래허가 대상인지·허가일·계약일을 모르면 중과로 계산하고 확인사항을 남깁니다.
• 증빙 자동 채움. 매매계약서, 취득세 영수증, 공사 세금계산서 같은 파일을 주면 Claude 가 값을 읽어 적고, 엔진이 원문 발췌와 대조해 맞는 값만 사실관계에 넣습니다. 그 뒤 남은 문항만 묻습니다. 스캔본·사진에서 읽은 값과 원문과 맞지 않는 값은 증빙_확인표.md 로 사용자에게 확인받습니다. 경비 영수증은 서류마다 따로 받아 이어 붙이고, 지급일·금액은 같고 나머지 값이 다른 줄이 두 서류에서 오면 넣지 않고 확인받습니다.
• 신고서 PDF. 예정신고 정기분과 예정신고를 한 번도 하지 않은 확정신고 정기분은 신고인 정보를 따로 받아 별지 제84호서식(본지·부표1·부표3)과 지방소득세 별지 제40호의11서식을 법령 서식 원본 위에 채웁니다. 만들기 전에 서식 검산이 란 사이 산식과 엔진 값을 다시 대조합니다.
• 확정신고 가산세. 예정신고를 한 번도 하지 않은 확정신고에는 예정신고 무신고가산세와 납부지연가산세를 국세와 지방소득세에 계산해 넣습니다. 무신고가산세는 감면 없이 100분의 20 으로 적고, 예정신고분을 기한 후 신고로 내서 감면이 적용될 때의 금액을 함께 보여 줍니다. 지방소득세 가산세는 예정신고기한과 원 미만 처리 방법을 가정한 값이라 위택스 화면의 가산세와 다르면 위택스 값을 따릅니다.
• 전액 비과세 자산. 과세 자산과 섞여 있으면 신고서에서 빼고 과세 자산만 신고합니다. 전액 비과세 자산뿐이면 신고서를 만들지 않습니다.
• 신고기한. 기한이 토요일, 일요일, 공휴일, 대체공휴일, 노동절이면 그 다음의 첫 평일로 옮깁니다. 공휴일 표에는 2025년부터 2027년까지 있습니다. 표에 없는 해의 연휴와, 표를 확인한 뒤에 지정된 임시공휴일은 반영하지 못합니다.
• 출력 파일. 출력 폴더에는 신고서 PDF 두 벌(양도소득세_신고서.pdf, 지방소득세_신고서.pdf)과 양도소득세_계산근거.xlsx 만 남습니다. 상태, 합계, 확인사항, 경고, 질문, 사람이 할 일은 화면 출력과 MCP 응답으로 나옵니다.
• 신고는 사람이. 홈택스·위택스 로그인과 제출은 사람이 합니다. 지방소득세는 위택스에서 따로 신고합니다.
• 인적사항. 성명, 주민등록번호, 주소는 사실관계와 따로 신고인.json 으로 받습니다. 신고서 PDF 에만 들어가고 화면 출력과 MCP 응답에는 싣지 않습니다.
• HTML 질문지. 고객이 브라우저에서 직접 채우는 파일 하나(질문지/양도소득세_질문지.html)가 들어 있습니다. 외부로 전송하지 않고 답을 사실관계 JSON 으로 내려받습니다.
• 로컬 MCP. scripts/mcp_server.py 로 다음 문항 받기, 답 넣기, 계산, 신고서, 지역 판정, 증빙 목록, 증빙 반영을 도구로 씁니다.

지금 계산하는 건은 2025-01-01 이후 매매와 경매(매각대금 완납일이 양도일)로 양도한 주택·토지·건물입니다. 조세특례제한법 감면은 계산하지 않습니다. 가산세는 예정신고를 한 번도 하지 않은 확정신고의 무신고가산세와 납부지연가산세만 계산합니다. 수용·교환·부담부증여·기타 원인으로 양도한 건, 상속·증여·입주권·분양권·겸용주택·비사업용 토지는 아직 다루지 않습니다.

기한후신고, 수정신고, 같은 해에 먼저 예정신고한 양도가 있는 신고, 대리 신고는 다루지 않습니다. 확정신고 가산세와 전액 비과세 자산의 처리에는 세무 전문가 확인이 남은 해석이 있고, 목록은 skills/양도소득세/references/적용한계.md 끝에 있습니다. 결과는 검토용이며 신고 전 최종 판단은 세무 전문가가 합니다.

법인세-통합고용

급여대장과 사원명부 엑셀 한 파일을 넣으면 사람별 · 달별 근무개월, 청년등 구분, 상시근로자 수를 세고 공제세액계산서와 상시근로자 명세서까지 채운 검증 워크북을 만듭니다. 숫자 칸은 모두 엑셀 수식이고, 파이썬 엔진이 날짜 계산으로 같은 값을 따로 내서 수식 값과 대조합니다. 검산 11개가 모두 통과해야 합니다.

• 청년 간주는 2025년 1월 1일 이후 계약만 대상입니다. 2024년 이전에 계약한 사람은 현재 연령만 봅니다. 회계사 확인을 거쳐 고친 값이고 근거 부칙은 SKILL.md 에 있습니다.
• 급여가 없는 달은 근무개월에서 뺍니다. 원천징수와 국민연금 · 건강보험료 납부 사실이 확인되지 않기 때문입니다(시행령 제23조 제10항 제6호). 무급휴직은 회사 시트에서 켭니다.
• 2 · 3차 연도 판정은 종전 방식입니다. 2024 · 2025 과세연도에 증가한 공제는 개정 부칙(법률 제21223호 제34조)으로 종전 규정을 따릅니다.
• 2026 과세연도는 기존공제와 신규공제를 함께 계산합니다. 기존공제(2024 · 2025 증가분의 2 · 3차 연도)는 종전 서식(1)에, 신규공제(직전 과세연도 대비 새 산식, 법 제29조의8 제1항)와 추가공제는 별지 제10호의9서식(2)에 적습니다. 2025 증가분의 2차 연도는 근로자별, 2024 증가분의 3차 연도는 월말 합으로 셉니다(시행령 부칙 제36127호 제11조 제1항). 회계사 확인을 거친 판단입니다. 2027 과세연도는 전전 대비(B)가 더해지고 계산합니다(전전전 대비는 2024 이전 개시 과세연도를 비교에서 빼므로 2027 까지는 없습니다). 2022 과세연도 이전은 통합고용세액공제가 없어 계산하지 않습니다.
• 신고용 서식은 법제처 원본 그대로입니다. 2 조서/통합고용_법정서식.pdf 는 법제처 별지 제10호의9서식 · 제10호의10서식 PDF 쪽을 그대로 두고 칸에 값만 넣은 것입니다. 사업자등록번호 · 대표자 · 날짜 · 서명은 사람이 적습니다. 워크북의 서식 시트는 같은 값을 수식으로 보이는 검증용이고 인쇄하면 법정 용지와 쪽에 맞습니다.
• 2026 과세연도 신규공제 · 추가공제 인원은 새 범위로 셉니다. 근로기간 1년이 된 달부터 넣고(입사일로 소급하지 않음), 단시간근로자는 그해 월 평균 근로시간 60시간으로 가립니다(시행령 제26조의8 제2항). 비교하는 직전 · 직전전 과세연도 인원도 새 범위로 다시 세고, 기존공제 2 · 3차 판정은 종전 범위로 둡니다. 「근로기간」 해석례가 아직 없어 회계사가 확인하지 않은 판단입니다. 엔진이 확인 항목으로 알립니다.
• 2026 과세연도부터 인원 끝수는 합계 뒤 버립니다. 사람별로 계산한 수를 더한 뒤 100분의 1 미만을 버립니다(시행령 제11조의2 제8항, 2026. 5. 22. 개정 부칙 제2조 제2항). 2025 과세연도까지는 사람마다 버린 뒤 더합니다.
• 더존 급여대장 PDF 를 바로 붙입니다. 달별 PDF 폴더를 kordoc(npx -y kordoc@^4)으로 표로 읽어 급여대장 시트에 넣고, 달마다 읽은 사람 수를 PDF 의 「합계(N명)」 과 맞춥니다. Node.js 18 이상이 있어야 합니다. 사원명부 · 회사정보 파일과 PDF 폴더를 한 번에 묶는 python -m ctax.employ.assemble 도 있습니다. 이전 판은 PyMuPDF 글자 좌표로 읽었고 파일 마지막 사람의 지급액에 합계 줄 숫자를 더하는 버그가 있었습니다.
• 샘플. --sample 이 만드는 합성 회사(직원 스무 명)로 설치를 확인합니다. 세액공제액 92,355,000원(2025 과세연도), --sample-year 2026 이면 69,740,000원, --sample-year 2027 이면 19,240,000원이 나오면 됩니다. 실제 회사 자료는 저장소에 없습니다.
• 판단은 회계사가. 임원 · 최대주주와 친족 · 계약기간 · 장애 구분은 사원명부에 적힌 대로 씁니다. 엔진은 그 값이 맞는지 보지 않습니다. 납부 확인은 급여대장 공제액으로 대신했습니다.

엑셀 재계산 대조는 윈도우의 엑셀에서만 돕니다. 맥 · 리눅스에서는 엔진 값을 내고, 워크북을 엑셀로 열면 같은 검산이 보입니다.

급여대장 및 원천세신고

급여 자료가 든 폴더 하나로 그 달 원천세 신고 파일까지 만듭니다. 급여대장 엑셀이 있으면 열 이름이 달라도 별칭으로 읽고(지급계 · 갑근세 · 주민세 등), 인사카드 · 급여계약 · 항목규칙 csv 만 있으면 급여대장부터 계산합니다. 자세한 것은 스킬 README에 있습니다.

• 과세표준을 제도마다 따로 만듭니다. 소득세 · 국민연금 · 건강보험 · 고용보험의 과세표준을 항목규칙대로 따로 계산합니다. 국외근로수당은 소득세 비과세이지만 건강보험 보수에는 들어갑니다(국민건강보험법 시행령 제33조 제1항 제3호 단서).
• 퇴사와 기타소득. 퇴직금을 평균임금 기준과 통상임금 기준으로 나란히 계산하고, 퇴직소득세와 1월부터 퇴사월까지의 중도정산을 같은 달 신고에 넣습니다. 강연료 · 인적용역 · 자문료는 필요경비 60% 를 뺀 금액의 20% 를 원천징수하고 A59 로 적습니다.
• 전자신고 파일. 국세청 전산매체제출요령(2026-05-16) 규격의 고정길이 파일을 만들고, 생성 코드와 따로 짠 형식검증 22개를 모두 통과해야 파일을 넘깁니다. 형식검증은 파일 형식만 봅니다.
• Drive 링크. Drive 폴더 · 파일 링크를 주면 Claude 가 세션의 Google Drive 커넥터로 내려받아 같은 순서로 돌립니다. 커넥터가 없거나 파일이 안 보이면 폴더 경로를 달라고 합니다.
• 근거목록과 최신화. 요율 · 간이세액표 · 비과세 한도 · 세율 · 공제 · 기한 · 소득코드 56개를 근거 조문 · 별표, TaxDoctor 원천 스냅샷 id, 시행일과 함께 references/근거목록.json 에 적었습니다. 「최신화」 를 부탁하면 TaxDoctor 와 법제처 korean-law 로 근거를 다시 읽어 판이 바뀌었거나 시행예정 개정이 걸린 값을 보고합니다. 값은 확인받은 뒤에만 고치고, 시험이 근거목록과 코드가 같은지 봅니다.
• 2026-11-02 기준 사람이 확인할 값. 장기요양보험료의 법령 식은 건강보험료 × (9,448/1,000,000 ÷ 719/10,000) 이고 끝수 처리는 법에 없습니다. 엔진은 이 비율을 0.1314 로 반올림해 씁니다. 계산값이 10원 단위 경계에 걸리면 10원 차이가 날 수 있습니다. 국민연금 근로자 부담률은 2027-01-01 부터 1만분의 500(국민연금법 부칙 제20903호 제4조)으로 계산합니다.
• 샘플 자료와 시험 코드는 싣지 않습니다. 자기 회사 한 달 자료로 바로 시작합니다.
• 노무 질문은 법령검토로. 수습 감액이나 근로자성 같은 질문은 법령검토 스킬이 답합니다. 이 스킬은 계산만 합니다.

월 중 입사 · 퇴사의 일할 계산, 퇴직연금(DB · DC) 가입자의 퇴직금, 미사용 연차수당, 부표가 필요한 소득(이자 · 배당), 연말정산 A04 ~ A06, 수정 · 기한후 신고는 다루지 않습니다. 홈택스 · 위택스 제출과 4대보험 신고는 사람이 합니다. 결과는 검토용이고 신고 전 판단은 담당 세무사 · 회계사가 합니다.

0.15.2 에서 이름을 「원천세신고」 에서 「급여대장 및 원천세신고」 로 바꿨습니다. 예전 이름 폴더(skills/원천세신고)에는 새 이름을 알리는 안내만 남겼습니다.

회계기준검토

기준서 원문을 문단 번호까지 읽고, 질의회신과 웹으로 최신성을 확인한 뒤, 금감원 감리지적사례 · 회계기준원 질의회신 · IFRIC Agenda Decision · Big4 간행물 · 상장사 공시로 결론을 반증합니다. 반례가 나오면 원문으로 돌아가 결론을 고칩니다.

• 기준. K-IFRS, 일반기업회계기준, 중소기업회계기준. 적용 대상부터 판별합니다.
• 원문은 각자 받아 둡니다. 기준서는 저작권 때문에 이 저장소에 넣지 않았습니다. 한국회계기준원 「시행중 회계기준」에서 PDF 를 받아 한 폴더에 두고 ACCOUNTING_STANDARDS_DIR 로 알려 주면 그 폴더를 읽습니다. 폴더가 없으면 웹으로 잠정 검토하고 "기준서 원문 미검증"을 첫 줄에 적습니다.
• 결과. 핵심쟁점 · 결론 · 회계처리(분개) · 상세설명 · 권위 사례 대조 순서의 자문 문서.

리스회계

계약서에서 개시일·기간·리스료·지급시점·보증금·할인율을 뽑아 조건 파일로 고정하고, 계산은 파이썬 엔진이 합니다. 현재가치, 유효이자율 상각, 정액 감가상각, 월별 전표를 만들고 엑셀 네 시트를 전부 셀 참조 수식으로 잇습니다. 입력가정의 할인율을 바꾸면 상각표와 전표가 따라 바뀝니다.

• 검산. 엔진 값을 연금 현재가치 닫힌 식과 맞추고, 엑셀 수식을 formulas 로 독립 재계산해 엔진과 맞춥니다. 차대 일치, 리스부채·사용권자산 기말잔액 0, 총리스료 − 리스부채 = 총이자를 확인합니다.
• 판단은 회계사. 내재이자율이 없으면 증분차입이자율 5% 를 자리값으로 두고 가정으로 표시합니다. 회사의 IBR 로 바꾼 뒤 확정합니다. 갱신·매수선택권, 단기·소액 면제도 회계사가 정합니다.
• 다루지 않는 것. 변동리스료, 리스변경 재측정, 복구충당부채 전입액, 다통화.

매입매출장검토

완성된 장부를 원천자료(매출집계·주문·정산·세금계산서·카드·현금영수증·은행) 옆에 놓고 검토항목 32개로 봅니다. 10개는 스크립트가 자동으로 대조하고, 나머지 22개는 항목마다 적힌 검토 방법대로 회계사가 봅니다.

• 누락은 원천에서 보입니다. 장부 안에서만 보면 빠진 매출(F1)과 일반전표로 간 세금계산서(F2)가 안 잡힙니다.
• 수정분개는 더존 양식으로. 원건을 음수로 지우고 정건을 양수로 넣습니다. 원장에는 적용하지 않고, 반영한 사본으로 다시 검토해 정지가 0건인지 봅니다.
• 규칙은 CSV. 채널의 총액·순액, 불공제 가맹점, 고정자산 계정을 고객사마다 CSV 로 적습니다. 들어 있는 규칙은 합성 예시입니다.

부가세신고서검토

장부가 맞아도 신고서는 틀릴 수 있습니다. 매입매출장검토로 장부를 닫은 뒤, 같은 장부에서 별지 제21호서식 본지를 다시 계산해 직원 작성본과 란별로 대조합니다. 검토항목은 40개이고 18개가 자동입니다.

• 부속명세 8종. 매출처별·매입처별 세금계산서합계표, 신용카드 수령명세서·발행금액집계표, 공제받지 못할 매입세액 명세서, 감가상각자산 취득명세서, 영세율 매출명세서, 계산서합계표를 장부에서 만들고 본지와 공급가액·세액 둘 다 0원으로 맞춥니다.
• 놓치기 쉬운 것. 전자신고세액공제 금액과 세무대리인 신고 여부, 법인의 신용카드 발행공제, 영세율 첨부서류(시행령 제101조) 누락을 따로 봅니다.
• PDF. 국가법령정보센터의 서식 원본 PDF 에 값만 얹어 신고서를 뽑습니다. 검토·보관용입니다. 제출용으로 쓰지 않습니다.

자금일보

계좌 거래내역 CSV 와 분류규칙 표 하나로 자금일보를 만듭니다. 은행 엑셀이든 데이터 플랫폼(예: Gridie)의 은행 연동 표든 열 이름만 맞추면 됩니다.

• 1원 검산이 먼저. 계좌마다 거래 한 줄씩 잔액이 이어지는지, 날마다 전일 잔액 + 입금 - 출금 = 계좌 잔액 합계인지 봅니다. 하나라도 어긋나면 파일을 쓰지 않고 날짜와 차이를 내고 멈춥니다. 계좌 간 이체는 입출금에서 양쪽 다 빼므로 이체의 한쪽만 놓쳐도 여기서 걸립니다.
• 분류는 표로만. 적요·거래처에 든 말로 자금코드를 붙입니다. 표에 안 걸린 거래는 비슷한 코드에 넣지 않고 「확인 필요」로 모읍니다. 규칙을 바꾸려면 표에 한 줄을 더하고 다시 돌립니다.
• 결과. 대시보드 HTML 한 파일(기준일 달력, 마감 잔액 추이, 자금코드별 유입·유출, 앞으로 2주 일자별 예측, 계좌별 잔액, 확인 필요 거래, PDF 인쇄)과 자금일보 md.
• 예측. 입출금 예정표는 그대로 쓰고, 판매 정산·매입처럼 반복되는 흐름은 최근 영업일 평균으로 채워 근거를 같이 적습니다. 평균이라 정산 주기와 계절성은 반영하지 않습니다.

예시는 지어낸 회사의 계좌 4개, 거래 688건입니다. 원화 계좌만 다루고, 은행 잔액 자체가 맞는지는 잔액증명과 따로 대조해야 합니다.

증권거래전표

법인 증권계좌 거래내역 파일을 읽어 전표를 만듭니다. 증권사마다 양식은 달라도 한 거래에서 뽑을 것(날짜 · 거래 종류 · 종목 · 수량 · 금액 · 비용 · 통화 · 잔액)은 같아서, 머리글 · 적요 사전으로 표준거래표에 옮긴 뒤 계산합니다.

• 읽는 자료. 삼성 · 키움 · 미래에셋 · 한국투자 · NH · KB · 신한 · 토스 · 대신 · 메리츠 등의 엑셀 · CSV · HTML xls, 글자 있는 PDF, 스캔 PDF와 화면 캡처(OCR, 선택 설치). PDF 는 읽는 방법 몇 가지를 전표까지 돌려 보고 증권사 잔액과 가장 잘 맞는 결과를 씁니다.
• 계산. 종목별 이동평균 원가, 통화별 외화예수금 장부금액, 해외 거래는 한국은행 매매기준율. 처분손익 · 외환차손익 · 배당과 현지세(외국납부세액) · 예탁금이용료 · 기말 평가 · 외화 환산까지 냅니다. 무상증자 · 분할 · 병합 같은 기업행위는 수량만 바꿉니다.
• 근거. 분개 규칙마다 일반기업회계기준 · K-IFRS 문단과 세법 조문(법인세법 제73조 원천징수, 시행령 제68조 귀속 등)을 붙였습니다. 기말 미수배당 · 연말 미결제 매매 · 세무조정은 전표에 넣지 않고 확인사항으로 올립니다.
• 검산. 원화 · 외화 잔액과 보유수량을 증권사 잔액과 줄마다 맞춥니다. 환율이 없거나 보유보다 많이 팔았거나 전표 차대가 안 맞으면 업로드 파일을 만들지 않습니다. 엔진 코드를 보지 않고 분개 규칙만으로 따로 만든 계산기로 사례 16개를 계산했습니다. 16개 모두 계정 순액이 엔진 값과 같았습니다.
• 결과. 파일 둘입니다. 위하고 일반전표 업로드 파일(적요 길이 · 계정코드 형식 · 날짜별 차대를 올리기 전에 검사)과 검증 파일(요약 · 전표 · 거래원장 · 기초·기말 네 시트)입니다. 둘 다 파이썬으로 계산한 값을 그대로 넣어(수식 없음) 엑셀이 없어도 나오고, 엑셀 판에 따라 값이 달라지지 않습니다.

단기매매증권(일반기업회계기준, K-IFRS 로는 당기손익-공정가치측정 금융자산)만 처리합니다. 매도가능증권 · 기타포괄손익-공정가치측정 지분, 채권 · 펀드, 세무조정은 다루지 않습니다. 실제 거래내역으로 맞춰 본 양식은 삼성증권(엑셀)과 미래에셋증권(거래내역증명서 PDF)뿐이고, 나머지는 공개 자료로 조사한 양식입니다. 새 양식은 첫 회에 실행보고의 「못 맞춘 머리글」 · 미분류를 봐야 합니다. 위하고(WEHAGO T)에는 가상 거래 8줄을 올려 변환옵션 기본값으로 그대로 들어가는 것을 확인했습니다(2026-11-08).

감사 스킬 셋(분개테스트 · DSD푸팅 · DSD변환)

외부감사 조서를 단계별 스킬로 나눠 만드는 감사 모듈에서, 감사 폴더 전체가 없어도 따로 돌아가는 단계를 떼어 공개합니다. 스킬마다 scripts/audit 에 감사 엔진 가운데 그 단계에 쓰는 부분만 들어 있습니다. 숫자는 엔진이 계산하고, 문서를 읽어 뜻을 정하는 일은 Claude 가 「확인 전」 으로 하고, 판단(중요성 · 결론 · 의견)은 회계사가 합니다.

• 분개테스트. 위험 대응 단계(3600-JET). 분개장으로 시험 스무 가지와 분포 분석을 돌립니다. 그 가운데 자기 승인 · 결산 후 입력 등 네 가지는 작성자 · 승인자 · 입력일시 열이 있어야 돕니다. 예시는 가상 회사 가온정밀(가상)의 분개장입니다.
• DSD푸팅. 보고 단계. 회사가 낸 dsd 의 숫자와 문장을 검증합니다. 엔진이 30초 안팎에 검토 화면(HTML)을 먼저 내고, Claude 는 틀린 곳만 봅니다. 화면에서 이전 판과 나란히 견주고 「수정」 을 누르면 수정판 dsd 를 만들어 다시 검증합니다. 자기 회사 dsd 로 시작합니다. 설치한 뒤 Claude 에게 「DSD푸팅 어떻게 써」 라고 하면 쓰는 법을 알려 줍니다.
• DSD변환. 보고 단계의 시작. 회사가 dsd 를 주지 않았거나 전기 dsd 가 없을 때, DART 공시 원문을 본문 그대로 편집기 dsd 로 바꿉니다. 요청하면 다음 기수 초안과 원고 엑셀까지 만듭니다. 만든 dsd 는 DART 편집기로 열어 본 뒤에 쓰고, 숫자는 DSD푸팅으로 검증합니다. 예시 자료는 싣지 않았고 공개된 감사보고서 접수번호로 시작합니다. OpenDART 인증키(환경변수 DART_API_KEY)가 있어야 접수번호로 받습니다.

예시 자료의 회사 · 사람 · 거래처 이름과 숫자는 모두 지어냈습니다. 고객 자료와 결과 파일은 저장소나 공유 폴더에 올리지 마십시오.

개선 제안

틀린 값, 다른 근거 조문, 다뤘으면 하는 경우를 이슈 양식으로 알려 주십시오. git 을 몰라도 됩니다. 고쳐서 PR 로 보내는 방법과 반영 방식은 CONTRIBUTING에 있습니다. 고객 실명과 실제 장부 파일은 올리지 않습니다.

고지

결과는 전문가 검토 전 초안입니다. 회계 처리와 세무 판단의 최종 확정은 사용자에게 있습니다. 예시와 테스트의 회사·금액은 합성하거나 바꾼 값입니다.

만든 사람

박상정(Hany). 재무·회계·세무 실무에 AI 에이전트를 붙이는 일을 합니다. 재무 AI 커리큘럼은 kernelacademy-web 에 공개하고 있습니다.

라이선스

MIT