hometax-doum

홈택스 도움 스킬

“부가세 신고, 무엇부터 준비해야 하죠?”

“매출과 실제 입금이 맞는지 확인하고 싶어요.”

“이번 달 세금 업무를 한 번에 정리해 주세요.”

혼자 챙기기 어려운 홈택스 업무를 AI와 함께 준비하세요. 소상공인·개인사업자·프리랜서를 위한 스킬 모음입니다. 사용하는 AI 앱에 설치하면, 평소 말하듯 요청해 필요한 자료와 다음 할 일을 안내받을 수 있습니다.

버전: 4.3.0 · 무료 스킬 6종 · 처음 시작 가이드

이런 일을 도와드려요

세무 용어를 몰라도 괜찮습니다. 지금 해야 할 일을 평소 쓰는 말로 알려주세요. 필요한 자료와 확인 순서를 함께 정리합니다.

지금 필요한 일	이렇게 요청하세요	받게 되는 도움
무엇부터 할지 모르겠어요	“이번 달 세금 업무 정리해줘.”	사업장 상황에 맞는 할 일과 준비자료 목록
부가세 신고가 다가와요	“부가세 신고 준비부터 도와줘.”	일반·간이과세 구분, 매출·매입 자료, 제출 전 확인
종합소득세를 준비해요	“종합소득세 신고 도와줘.”	필요한 자료, 신고 화면 순서, 신고 후 확인할 일
세금계산서를 발행해야 해요	“세금계산서 발급 전에 점검해줘.”	거래처·금액·청구/영수 확인, 발급·수정·조회 안내
카드·영수증이 쌓였어요	“사업 관련 지출을 분류해줘.”	지출 분류, 증빙 누락과 공제·불공제 후보 확인
아직 못 받은 돈이 있어요	“계산서와 입금내역을 확인해줘.”	미수금·부분입금·선금 등 확인할 거래 정리
면세사업자예요	“사업장현황신고 준비해줘.”	병의원·동물병원·약국·학원·주택임대·인적용역 등의 자료·첨부 안내
외주비를 지급했어요	“어떤 자료와 신고가 필요한지 알려줘.”	원천세·지급명세서 준비 목록
증명서가 필요해요	“대출에 필요한 세무서류를 점검해줘.”	문서 종류·귀속기간·발급일·누락 확인
신고 후에도 불안해요	“신고·납부·환급 상태를 나눠 확인해줘.”	접수증·납부 결과·환급 입금을 각각 확인

개업·사업자등록 정정·휴폐업·현금영수증·신고 정정·기한연장 등도 포함해 개인사업자 24개 업무 묶음을 안내합니다. 전체 업무 목록에서 업무별 지원 수준을 확인할 수 있습니다.

처음에는 이 문장 하나면 됩니다

설치한 AI 앱의 새 대화에 아래 문장을 복사하세요.

홈택스 도움 스킬로 내 사업장 상황부터 확인해줘.
업종, 과세유형, 직원 유무, 확인할 기간 중 필요한 것만 질문하고,
이번 달 할 일과 준비자료를 정리해줘.
자료가 없거나 확인하지 않은 항목은 미확인으로 남겨줘.

이후에는 “부가세부터 준비하자”, “이 파일에서 빠진 자료를 찾아줘”처럼 이어가면 됩니다. 스킬이 여러 개 설치되어 있다면 홈택스 도움 스킬로라는 표현을 함께 말해 주세요.

사용 흐름은 사업장·기간 확인 → 자료 준비 → 점검 → 홈택스 화면 확인 → 결과 증빙 확인입니다. 실제 화면을 함께 보려면 AI 앱에 브라우저 연결 도구가 필요합니다. 로그인·인증과 마지막 제출·발급·납부는 본인이 진행합니다.

Free와 Pro는 무엇이 다른가요?

Free는 필요한 자료와 화면 순서, 수동 점검을 돕습니다. Pro는 계산과 여러 파일의 일괄 대조를 더합니다.

기능	Free · 무료 6종	Pro · 9종
24개 업무의 준비자료·화면 안내	제공	포함
9개 업종·상황별 준비목록	제공	포함
영수증 분류·미수금 수동 점검	제공	포함
종소세·원천징수 예상액 계산	준비자료 안내	지원 범위 내 계산·검산
매출·정산·입금 파일 대조	수동 확인표	파일 변환·일괄 대조·보고서
업종별 8개 계산 모드	자료 준비·수동 확인	지원 조건 내 계산·화면 금액 비교
증명서 기간·발급일·누락 점검	수동 확인표	입력한 서류 조건 일괄 대조
사업자등록 신청·정정	기본 안내	전용 스킬로 상세 안내

Pro는 Free 6종에 종소세 준비·계산, 원천세, 사업자등록 전용 스킬 3종을 더한 구성입니다. 법인세는 별도 제품 범위이며 이 패키지에 포함되지 않습니다.

내 업종에도 사용할 수 있나요?

온라인판매·소매, 음식점, 제조, 프리랜서, 학원·면세 서비스, 병의원·의료업, 상가임대, 주택임대, 수출·과세면세 겸영의 9개 업종·상황에 맞춘 준비목록이 있습니다.

예를 들어 “온라인 판매를 하는데 정산금이 매출보다 적어”, “학원 사업장현황신고 자료를 준비하고 싶어”처럼 요청하세요. 업종명만으로 과세유형이나 공제 자격을 정하지 않고 실제 조건과 자료를 확인합니다. 업종별 준비 안내

설치하고 시작하기

이 저장소는 Free 공개판입니다. 윈도우·맥·리눅스에서 사용할 수 있습니다. 지금 쓰는 방법을 고르세요. 사용하는 AI 앱의 이용조건과 브라우저 연결 환경은 별도로 확인하세요.

지금 쓰는 것	설치	Python	운영체제
Claude Code	아래 플러그인 두 줄	필요 없음	윈도우·맥·리눅스 같음
.skill 업로드 앱	데스크탑용 .skill 6개 추가	필요 없음	윈도우·맥 같음
Codex 등 폴더 스킬 (Windows)	py -3 install.py	3.10 이상	Windows
Codex 등 폴더 스킬 (Mac/Linux)	bash install.sh	3.10 이상	macOS·Linux·Git Bash

Claude Code를 사용한다면

Claude Code 대화창에서 다음 두 줄을 차례로 입력하세요. 윈도우와 맥이 같습니다.

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

무료 스킬 6종이 함께 설치됩니다. 업데이트할 때는 /plugin marketplace update lbiz-partners로 마켓플레이스를 갱신하고 설치된 플러그인의 버전을 확인하세요.

.skill 업로드를 지원하는 앱이라면

전달받은 ZIP의 데스크탑용 .skill 파일 6개를 앱의 스킬 설정에 추가하세요. 터미널과 Python이 없어도 됩니다. 설치 방식은 처음 시작 가이드에 정리했습니다.

폴더 스킬을 사용한다면 (Windows · Mac · Linux)

1. 이 페이지의 Code → Download ZIP으로 내려받아 압축을 풉니다.
2. 압축을 푼 폴더로 이동합니다. 전달용 ZIP은 2_CLI용_폴더스킬 폴더를 사용합니다.
3. 아래 중 환경에 맞는 명령을 실행합니다.

Windows (PowerShell) — Python 3.10 이상. py 실행기가 없으면 python install.py ...처럼 -3도 빼고 실행하세요.

py -3 install.py --check
py -3 install.py --target-dir $env:USERPROFILE\.codex\skills
py -3 install.py --doctor --target-dir $env:USERPROFILE\.codex\skills

실행 정책 때문에 install.ps1이 막히면 위 py -3 명령을 쓰세요. install.ps1은 같은 설치기를 실행합니다.

Mac / Linux / Git Bash

bash install.sh --check
bash install.sh --target-dir ~/.codex/skills
python3 -B install.py --doctor --target-dir ~/.codex/skills

설치기는 기존 스킬을 백업한 뒤 교체합니다. 앱별 폴더는 아래와 같습니다.

앱	Windows	Mac / Linux
Codex	%USERPROFILE%\.codex\skills	~/.codex/skills
Claude Code 폴더 설치	%USERPROFILE%\.claude\skills	~/.claude/skills
Aside	%USERPROFILE%\.aside\u\0\skills\user	~/.aside/u/0/skills/user

인자 없이 실행하면 설치된 앱 폴더를 찾아 넣습니다. 앱을 못 찾으면 --target-dir로 지정하세요.

--doctor는 설치된 Free 6종의 누락·변경·심볼릭링크를 읽기 전용으로 확인합니다. 출력의 HEALTHY는 파일 상태가 원본과 같다는 뜻입니다. 파일 상태만 확인했으며, 앱의 스킬 인식 여부는 확인하지 않습니다.

그 다음 앱을 완전히 새 대화로 열어 “홈택스 도움 스킬로 이번 달 할 일을 정리해줘”라고 요청하고, 해당 스킬이 선택되는지 별도로 확인하세요.

어디까지 확인된 기능인가요?

공개 검증 기록은 24개 대표 경로의 메뉴 진입·로그인 요구·공개 조회와 가상자료 모의계산을 구분합니다. 모든 하위 기능이나 실제 신고·발급·납부를 완료했다는 뜻은 아닙니다. 업무별 공개 확인 범위

• 계산은 지원 연도·유형·자료 범위 안에서 수행합니다. 일부 금액의 일치는 최종 세액이나 신고서 전체의 적정성을 뜻하지 않습니다.
• 자료가 없거나 확인하지 못한 값은 미확인으로 남깁니다. 신고 접수·납부·환급 입금도 따로 확인합니다.
• 로그인·인증과 최종 제출·발급·납부는 본인이 진행합니다. 비밀번호·인증서 암호·OTP를 AI에 알려주지 마세요.
• 자료의 주민번호·계좌번호 등 불필요한 식별정보는 가리거나 가명으로 바꿔 주세요.
• 복잡하거나 지원 범위 밖의 세무 판단은 필요한 자료와 쟁점을 정리해 전문가 검토로 연결합니다.

본 도구는 신고 준비를 돕는 소프트웨어입니다. 이용 조건은 LICENSE를 확인하세요.

개발·출고 점검

python3 -B scripts/validate-routing.py --edition free
bash scripts/build.sh
python3 -B scripts/release-readiness.py --check-manifest --directory ..
python3 -B scripts/release-readiness.py --tag-readiness

라우팅 검사는 Free에 허용된 6종과 필수 경계 사례를 확인하며 Pro 계산 엔진이나 모델을 실행하지 않습니다. READY_TO_TAG는 로컬 작업트리와 예상 태그의 충돌이 없다는 뜻일 뿐, 태그 생성·GitHub Release·원격 배포 완료를 뜻하지 않습니다.

업데이트 내역

v4.3.0 (2026-09-19) — 가산세가 있는 세 업종: 병의원·동물병원·약국

• 동물병원(수의업)·약국(약사업) 전용 안내도 함께 넣었습니다. 사업장현황신고 불성실 가산세는 이 세 업종에만 있습니다. 동물병원은 농림축산식품부 고시 별표로 면세를 가르고, 약국은 조제용역과 재화 판매의 경계를 먼저 확인합니다. 두 업종은 전용 수입금액 검토표가 없어 신고서 본표·계산서합계표가 중심입니다.
• 병의원·치과의원·한의원 전용 준비 안내를 추가했습니다. 병의원 사업장현황신고 준비에서 채널별 수입 수집 → 입금액의 진료 기준 환산 → 의료업자 수입금액 검토표 → 신고서 본표 대조 → 현금영수증 자가점검 순서로 확인합니다.
• 의료업만 다른 세 가지를 앞에 세웠습니다. 사업장현황신고 불성실 가산세(0.5%)는 의료업·수의업·약사업에만 적용되고 산출세액이 0원이어도 부과되며, 전용 검토표를 첨부하고, 수입을 입금이 아니라 진료일 기준으로 적습니다.
• 현금영수증 의무가입까지 다룹니다. 신규 개원은 사업개시일부터 60일, 미가입 가산세는 과세기간별로 계산합니다. 발급 거부 5%와 의무발행 미발급 20%의 갈림길도 구분했습니다.
• 검토표 구조를 그대로 따른 빈 확인 양식(JSON)을 함께 넣었습니다. 모르는 값은 0원이 아니라 미확인으로 남깁니다.
• 법령·서식만으로 확정되지 않는 3건(치과 검토표 구분, 검토표 비보험란의 과세 비급여 포함 여부, 「해당 과세기간 진료분 미수령액」 칸의 중복)은 미해결로 표시하고 확인 방법·기록할 것을 안내에 적었습니다.
• 근거와 확인일은 병의원 근거 문서에 있습니다. 면세 여부·신고 의무·수입 귀속시기·가산세·세액을 자동 판정하거나 계산하지 않고, 공식 서식을 대신 작성·제출하지 않습니다.
• 출고 검증: 적대적 리뷰 13회의 지적을 반영했고, 무료 배포 게이트·미수금 회귀·설치/릴리스 회귀·데스크탑 번들 내용 바이트 대조를 통과했습니다. 차수별 판정과 아직 남은 확인 사항은 리뷰 기록에 그대로 적어 두었습니다. 소프트웨어 검증이며 실제 홈택스 신고를 수행한 결과가 아닙니다.

v4.2.0 (2026-09-17) — 기준일 확인과 Free 모드 선언

• 모든 스킬이 시작할 때 오늘 날짜(기준일)를 시스템 시계나 사용자에게 확인하고 보고 머리에 적습니다. 전자신고 공제 금액, 기한후 여부, 미수금 경과일수 판단이 이 날짜에 걸리기 때문입니다.
• 허브가 Pro 엔진 파일의 존재를 확인해 첫 보고에 Free 모드 또는 Pro 탐지를 선언합니다(파일을 볼 수 없는 앱에서는 Free 모드로 진행). Free 모드에서는 허브 본문과 보고에서 Pro 도구 이름을 쓰지 않고 안내·자료 준비·수동 대조로 같은 절차를 끝까지 진행합니다.
• 스킬 설명에 호출어 "홈택스 도움 스킬"과 스킬 간 역할 경계를 적었습니다.
• 영수증 분류에 입력 파일 실측 포맷 안내와 14열 출력 템플릿(CSV)을 추가했습니다. 실측하지 않은 포맷은 미실측으로 표시하고 추정 컬럼으로 읽지 않습니다.
• 실화면 검증 기록 JSON을 스킬 패키지 밖(docs/verification/)으로 옮겨 허브 스킬이 가벼워졌습니다. 업무 목록 표는 JSON에서 생성합니다.
• 내부 정비: 공통 문단(면책·프로필 재사용·실화면 원칙)을 단일 원본으로 관리하고 게이트가 대조합니다. 공통 6종 스킬의 정본은 Pro 저장소이며 내보내기로 동기화합니다. 세율·기한·안내 내용은 바꾸지 않았습니다.

v4.1.2 (2026-09-17) — 윈도우·맥에서 설치 방법 고르기

• 지금 쓰는 앱에 맞춰 Claude Code 플러그인, .skill 업로드, 폴더 설치를 표로 구분했습니다.
• 폴더 설치는 Windows용 install.py / install.ps1과 Mac·Linux용 install.sh를 함께 제공합니다. Python 3.10이면 운영체제가 달라도 같습니다.
• Aside 기본 설치 위치를 실제 스킬 폴더(~/.aside/u/0/skills/user)로 맞췄습니다.

v4.1.1 (2026-09-17) — 더 쉬운 사용 안내와 공개 범위 정리

• 사용 예시와 설치 순서를 앞세워 처음 사용하는 분도 시작하기 쉽게 안내를 정리했습니다.
• 개인·사업자 상태, 추가 인증, 조회 전 초기 값과 실제 결과를 구별하는 안내를 보강했습니다.
• 공개판에는 공개 메뉴·가상자료 확인 기록만 포함합니다. 개인 계정에서 얻은 조회 결과와 인증 후 관찰 기록은 배포하지 않습니다.

v4.1.0 (2026-09-17) — 업종별 준비와 실화면 확인

• 소매·음식점·제조·프리랜서·학원·임대·수출·겸영의 자료 준비와 수동 대조 안내를 추가했습니다.
• 실제 홈택스 검증 기록은 메뉴 진입, 로그인 요구, 공개 조회·모의계산 결과를 구분합니다. 로그인 후 전체 업무를 통과했다는 뜻은 아닙니다.
• Free는 공통 안내·템플릿을 제공하며, 업종별 계산 엔진과 선택한 화면 금액의 자동 비교는 Pro에서 제공합니다.

v4.0.0 (2026-09-17) — 개인사업자 24개 업무

• 무료 기본 안내를 사업자등록·휴폐업·현금영수증·인건비·증명·환급·정정·지원까지 넓혔습니다. 업무별 준비와 완료 확인을 한 목록에서 찾습니다.
• Pro는 명시적 CSV/XLSX 변환, 원자료·신고값 산술 대조, 원문 확인된 서류의 요구조건 검사를 더합니다. 실제 세금신고·발급·납부는 사용자가 진행합니다.
• 공식 근거와 실화면 검증 범위를 구분합니다. 무료 6종·Pro 9종 구성과 기존 계산 지원 범위를 유지합니다.

v3.9.0 — 면세사업자 사업장현황신고

• 학원·주택임대·인적용역·기타 면세 준비 안내와 빈 확인 양식을 추가했습니다. 사업장현황신고 안내에서 대상·서류·수입 중복·접수 확인을 구별합니다.
• 무료는 안내·수동 확인표, Pro는 연간 수입·매입 집계와 작성 항목 대조를 제공합니다. Pro 전용 코드는 공개판에 포함하지 않습니다.
• Pro의 카드·현금영수증 분류 충돌 차단, 출처 URL 검증, 보고서 기준일 표시도 보완했습니다.
• 기능 릴리스 검증: 무료 배포 검사 75개, 미수금 회귀 24개, 설치·릴리스 회귀 8개와 패키지 원본 대조를 통과했습니다. 이는 가상자료·소프트웨어 검증이며 실제 홈택스 신고를 수행한 결과는 아닙니다.
• 2026-09-13 README 정리: 사용 문장을 맨 앞에 배치하고 무료·Pro 비교와 설치 방법을 바로 찾도록 구성했습니다.

v3.8.0 — 1인 대표의 월간 홈택스 업무

• 사업장 설정과 이번 달 할 일, 지출 증빙·매출 대조 안내를 보강했습니다.
• 신고 접수·국세 납부·지방세·환급 상태를 구분합니다.
• 면세사업자·국세증명·환급금·세금포인트 안내를 연결했습니다.
• 공식 근거와 확인일을 함께 제공합니다. 기존 Pro 3.7의 공통 안내 정정도 반영했습니다.

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

소상공인·개인사업자·1인 대표가 필요한 자료를 정리하고 실무를 이어갈 수 있도록 도구와 활용 안내를 만듭니다.

• 홈페이지: lbiz-partners.com
• Pro 문의: 엘비즈파트너스 카카오톡 채널

이용 안내

본 스킬은 신고 준비와 화면 안내를 돕는 참고용 소프트웨어이며 「세무사법」 제2조의 세무대리를 수행하지 않습니다. 최종 세무 판단·신고·납부의 책임은 이용자 본인 또는 위임받은 세무 전문가에게 있습니다.

LICENSE — 개인·사내 사용, 수정, 비상업적 공유 가능. 재판매·Pro 재배포는 금지합니다.

개발용 훅은 저장소 개발 세션에만 적용하며 고객 ZIP에는 넣지 않습니다. 스킬 사용자에게 개발용 작업 폴더를 열도록 요구하지 않습니다.

개발 시에는 git config core.hooksPath .githooks로 훅을 활성화합니다. 빌드는 bash scripts/build.sh이며 무료 코드 경계·회귀·설치·ZIP 바이트 대조를 통과한 산출물만 생성합니다.