🧾 홈택스 도움 스킬 (hometax-doum)

AI 에이전트(Claude·Codex·Aside)에게 말로 시키면, 홈택스 세무 작업을 제출·발급 직전까지 안내해 주는 무료 스킬 모음입니다. 부가가치세 · 종합소득세 · 전자세금계산서를 다루는 개인사업자·프리랜서용.

세무 지식이 없어도 됩니다. "부가세 신고 도와줘" 한마디면 화면 순서·확인할 숫자·놓치기 쉬운 함정을 옆에서 짚어줍니다. 세무사에게 맡기기 전에, 또는 직접 신고하는 분이 혼자서도 막히지 않게 돕는 것이 목표입니다.

✅ 무료로 이만큼 됩니다

이 저장소 6종만으로 홈택스 3대 작업을 제출·발급 직전까지 스스로 진행할 수 있습니다.

• 부가세: 미리채움 조회 → 매출·매입 대조 → 놓치기 쉬운 공제(전자신고·전자세금계산서 발급세액)까지 제출 직전 점검
• 종소세: 모두채움/일반 신고, 경비율 vs 간편장부 선택 점검, 제출 직전 QA
• 세금계산서: 발급·수정발급·조회 — 기존 거래처는 질문 5개 패스트트랙(저장된 정보 재활용, 반복 거래는 "지난달과 같아요" 한마디)으로 빠르게, 신규 거래처는 꼭 필요한 7가지만 한 번에 물어서 쉽게 발행. 금액 자릿수·청구/영수·과세구분·거래처 확인으로 실수 방지
• 미수금 점검: 청구로 발행한 세금계산서를 통장 입금내역과 대조해 못 받은 돈을 찾아줍니다. 건수 검증 게이트와 "애매하면 임의 판단 대신 사장님께 확인" 원칙으로 건이 조용히 사라지지 않게 설계했고(현금·상계처럼 통장에 안 잡히는 결제는 확인 질문으로 보완), 경과일수별 경고(독촉 → 내용증명 검토 → 지급명령·소멸시효 주의)로 다음 할 일까지 짚어줍니다. 미입금이어도 매출 신고는 필수라는 세무 함정, '영수'로 잘못 발행된 미수금의 분쟁 리스크까지 경고합니다

전부 홈택스 화면을 최종 근거로 삼고, 제출·발급·납부 버튼은 반드시 본인이 누르는 구조라 안심하고 쓸 수 있습니다.

설치 (1분)

Claude Code — 마켓플레이스 (권장)

Claude Code에서는 마켓플레이스로 한 번에 설치하고 자동 업데이트를 받을 수 있습니다:

/plugin marketplace add lbiz-partners/hometax-doum
/plugin install hometax-doum@lbiz-partners

설치하면 6종 스킬이 함께 들어옵니다. 저장소가 갱신되면 /plugin marketplace update lbiz-partners로 새로 고칩니다.

그 외 도구 — 수동 복사

이 저장소를 다운로드(Code → Download ZIP 또는 git clone)한 뒤, 쓰는 도구의 스킬 폴더에 복사:

cp -R skills/* ~/.claude/skills/          # Claude Code
cp -R skills/* ~/.codex/skills/           # Codex
cp -R skills/* ~/.aside/u/0/skills/user/  # Aside

Claude Desktop 앱은 각 스킬 폴더를 zip으로 압축해 설정 → Skills에 업로드하면 됩니다.

참고: 이 저장소 폴더 자체를 Claude Code의 작업 폴더로 열면 개발용 검증 훅(.claude/)이 활성화됩니다. 스킬을 사용하는 데는 필요 없는 장치이니, 위처럼 skills/만 복사해 쓰세요. (스킬을 직접 수정·기여하려는 경우에만 해당 — CLAUDE.md 참조)

설치 확인: 새 대화에서 "세무 도와줘" → 안내가 나오면 성공.

팁 (Codex·Aside 등 다른 도구): 스킬이 많이 설치된 환경에서는 범용 문구가 다른 스킬로 갈 수 있습니다. "홈택스 스킬로 부가세 신고 도와줘", "tax-invoice-hometax 스킬로 미수금 점검해줘" 처럼 스킬을 특정하면 확실하게 발동합니다.

안전 규칙 (모든 스킬에 내장)

1. 홈택스 로그인·인증서·OTP는 본인만 입력 — AI에게 비밀번호를 주지 않습니다
2. 최종 제출·발급 버튼은 반드시 본인이 — AI는 "이 내용으로 진행해도 될까요?" 확인까지만
3. 홈택스에 없는 숫자를 창작하지 않음, 공제/불공제는 단정 대신 "후보 + 확인 질문"
4. 주민번호·계좌 등 식별정보는 마스킹·최소 입력
5. 문제가 있으면 제출 권유 자체를 차단

🔒 Pro — 직접 "계산"까지 해주는 엔진 2종 (별매)

무료 모음은 홈택스 화면 안내자입니다(위 6종으로 충분히 신고·발급 가능). Pro는 여기에 숫자를 코드로 직접 계산하는 엔진 2종을 더합니다 — 이 둘은 세금 종류가 서로 다릅니다.

① 종소세 예상세액 엔진 · jongsose-prep-kr — "내 세금 얼마 나올까?"

내가 내는 내 종합소득세를 미리 계산합니다.

• 5월을 기다리지 않고 연중 아무 때나 예상세액 계산 (2026 정부 원문 검증 세율, 코드가 계산)
• 겸업(직장+3.3% 부업) 합산 — 근로소득공제·세액공제 자동 반영
• 분납 가능 여부, 성실신고 대상 판정, 기한후 가산세 감면율
• 미리채움 교차검증 — 홈택스 숫자를 독립 계산으로 검산해 매출 누락·이중계상을 제출 전에 적발
• 홈택스 입력표 + PDF 보고서

무료의 income-tax-hometax가 "5월에 화면에서 신고"까지라면, 이 엔진은 "그 전에 얼마 나올지 계산"까지입니다.

② 원천세(인건비) 신고·계산 엔진 · withholding-tax-hometax — "직원 급여에서 얼마 떼지?"

직원·일용직·프리랜서에게 인건비를 지급하는 사장을 위한, 완전히 다른 세금(원천세)입니다.

• 월급·부양가족을 넣으면 국세청 근로소득 간이세액표로 원천징수액 자동 계산(자녀공제 반영)
• 일용직 6%, 프리랜서 3.3%, 기타소득(강연료 등)까지 코드 계산
• 원천징수이행상황신고서(매월/반기) 작성 보조 + 급여대장 ↔ 홈택스 대조
• 지급명세서·간이지급명세서 기한 점검(놓치면 가산세), 반기납부 자격 확인
• 홈택스·급여프로그램 없이도 "월급 250만·부양2 → 원천징수 얼마"가 바로 나옴

한눈 비교

정리: 직접 신고하는 분은 무료 6종으로 충분합니다. "세금이 미리 얼마 나올지 알고 싶거나", **"직원 인건비 원천세까지 처리"**해야 하면 Pro 엔진이 도와줍니다.

Pro 문의: 엘비즈파트너스 카카오톡 채널

📝 업데이트 내역

2026-08-09 — 미수금 점검 모드 신설: 청구로 발행한 세금계산서, 돈 받았는지 자동 대조

tax-invoice-hometax에 미수금 점검 모드가 새로 생겼습니다. "미수금 확인해줘" 한마디로 시작합니다.

• 청구 발행 건 ↔ 통장 입금내역 대조 — 홈택스에서 내려받은 매출 세금계산서 발급 목록과, 은행에서 다운로드한 입금내역(엑셀/CSV)을 올리면 건별로 자동 추적·대조합니다. 입금내역이 없으면 건별 질문 방식으로도 진행됩니다.
• 못 받은 돈이 조용히 사라지지 않게 — 입금 1건은 계산서 1건에만 배정(소진 규칙), 부분입금·합산입금·선금·카드/PG 정산처럼 애매한 건은 임의 확정 대신 "판단불가"로 내려 사장님께 확인합니다. 대조 전후로 정합성 게이트 2중 검증(총건수=영수+청구, 입금완료+미입금+판단불가=청구 건수)을 통과해야 결과를 보고합니다 — 건이 누락되면 보고 자체가 막히는 구조입니다.
• 다음 할 일까지 — 결제기일 기준 경과일수별 단계 경고(정상 → ⚠️독촉 → 🔶내용증명 검토 → 🔴지급명령·소멸시효 주의). 영수로 발행했는데 입금 흔적이 없는 건도 역점검해 분쟁 리스크를 경고합니다.
• 세무 함정 3고지 — 미입금이어도 부가세 매출 신고는 전액 대상(빼면 매출 누락), 대손세액공제는 법적 대손 확정 시에만, 이 점검은 수금 관리용(신고 내용 불변)임을 시작 전에 안내합니다.
• 발행 흐름도 개선: 기존 거래처는 질문 5개 패스트트랙, 신규 거래처는 필수 7가지만. 출시 전 독립 적대적 리뷰로 CRITICAL 1건·HIGH 4건 포함 13건을 수정한 뒤 공개했습니다.

2026-08-09 — 홈택스 실화면·다운로드 엑셀 실측 반영

2026년 8월 홈택스 실제 화면과 실데이터로 검증해 안내를 갱신했습니다.

• 발급 목록 조회 기간 3개월 상한 반영 — 긴 기간은 나눠 받아 병합하도록 안내하고, 구간 공백·중복까지 검증
• 다운로드 엑셀의 실제 구조(상단 5행 메타 → 6행째 헤더, 영수/청구 구분 컬럼 위치 등)를 실데이터 7건으로 검증해 대조 절차에 반영
• 내려받기 팝업 순서, 마지막 저장 확인 창은 본인 클릭 필요 등 실측 동선 반영

2026-08-09 — 개발 하네스 도입: 검증 없인 배포되지 않는 구조

스킬 품질을 "문서 약속"이 아니라 강제 장치로 지키도록 저장소에 하네스를 심었습니다.

• 결정론 게이트 62종 — 안전 문구(입금 소진 규칙·선금 확인·과세구분 등) 삭제, Pro 파일 유출, 면책 누락을 푸시 전에 자동 실격 처리
• 미수금 회귀 테스트 24종 — 소진·선금·순액·취소·경계 케이스가 코드로 고정되어, 대조 규칙이 바뀌면 테스트가 막습니다
• 적대적 리뷰 강제 — 스킬 수정은 독립 리뷰어의 반박 리뷰 영수증 없이는 세션이 끝나지 않음
• push 시점 게이트 — 어떤 도구로 수정하든 push되는 커밋 자체를 검사(도구 중립), 검증 안 된 커밋은 배포 경로에 오르지 못합니다

2026-07-24 — 자격·면책 강화 + 정확성·개인정보 보완 (6개 스킬)

전문가(세무사) 존중과 이용자 보호를 위해 6개 스킬의 안내·면책을 정비했습니다.

• 자격·면책 명확화 — 모든 스킬 말미 면책을 「세무사법」 제2조(세무대리 정의)·제20조제3항에 맞춰 강화. **"이 도구는 신고 준비를 돕는 소프트웨어이며 세무대리·세무상담이 아니다(신고서 작성·제출 대행 안 함), 최종 판단·책임은 이용자 본인, 필요하면 등록 세무사에게 위임"**을 명시.
• 세금계산서 발급 — 클릭은 본인이 — tax-invoice-hometax가 발급·영수/청구 버튼을 대신 누르지 않고 안내만 하도록 정비.
• 부가세 간이과세 판정 기준연도 정정 — 간이과세자 여부는 직전연도 공급대가(§61), 납부면제는 당해연도(§69) 기준임을 구분해 오판정 방지.
• 개인정보 보호 — 식별정보 마스킹·최소 입력 안내 추가.

2026-07-23 — 세금계산서 발급: 금액 자릿수 대조 추가

"200만원 끊어줘"라고 했는데 화면에 20,000,000(2천만원)이 들어가면 발급 전에 "말씀하신 금액과 달라요, 맞나요?"라고 잡아줍니다. 0 하나 더 치는 실수를 막습니다.

2026-07-23 — 세금계산서 발급 실무 개선 2종

• 청구/영수 자동 선택 — "대금 이미 받으셨나요?"를 먼저 물어 받았으면 영수, 아직이면 청구로 자동 선택 후 재확인.
• 기존/신규 거래처 구분 — 기존은 저장 정보 불러오기, 신규는 사업자번호 조회, 공통으로 휴·폐업 확인.

2026-07-22 — 부가세 경감·공제세액 2종 점검 강화

개인사업자가 놓치기 쉬운 전자신고 세액공제(2026.1기부터 5,000원)와 전자세금계산서 발급세액 공제(직전연도 3억 미만 개인, 건당 200원·연 100만원 한도)를 제출 직전 체크리스트에서 자동으로 짚습니다.

엘비즈파트너스가 만듭니다

이 스킬은 엘비즈파트너스가 만들어 무료로 공개했습니다.

세무·노무·법무·경영 컨설팅과 AI 활용 교육을 하면서, 중소상공인·중소기업 대표님이 혼자서도 실무를 덜 헤매도록 돕는 자료와 도구를 꾸준히 정리해 두고 있습니다. 이 홈택스 스킬처럼 바로 쓸 수 있는 것부터, 법인전환·가업승계·정책자금처럼 판단이 필요한 주제까지 —

• 홈페이지 · lbiz-partners.com
• 카카오톡 채널 · @lbizpartners

필요할 때 한 번 둘러보시면, 생각보다 바로 쓸 만한 게 많을 겁니다.

면책

본 스킬은 신고 '준비'와 화면 안내를 돕는 참고용 소프트웨어이며, 「세무사법」 제2조의 세무대리·세무상담이 아닙니다. 최종 수치의 근거는 홈택스 화면이고, 신고·납부의 최종 판단·책임은 이용자 본인에게 있으며 필요하면 등록 세무사에게 위임하세요.

라이선스

LICENSE — 개인·사내 사용, 수정, 비상업적 공유 자유. 재판매·유료 재배포 금지.