hometax-tax-hub
홈택스 도움 스킬의 진입점. 개인사업자의 개업부터 매출·지출, 신고, 납부·환급, 증명, 정정·폐업까지 홈택스 업무를 연결한다. '홈택스 도움 스킬로', '이번 달 세금 업무', '무엇부터 해야 할지' 같은 요청과 여러 업무가 섞인…
개인사업자의 전자세금계산서·계산서·현금영수증 발급·수정·취소·조회 준비, 현금영수증 가맹점 가입 판정·신청과 미수금·정산 대조에 사용한다. 부가세 신고서 작성은 vat-hometax가 맡는다. 최종 발급은 본인이 진행하며 Pro 대조 엔진이 없으면 수동 확인으로 진행한다.
Claude Code
$ npx -y skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax --agent claude-code
Codex
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a codex -y
Cursor
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a cursor -y
Gemini CLI
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a gemini-cli -y
GitHub Copilot
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a github-copilot -y
OpenCode
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a opencode -y
Windsurf
$ npx skills add lbiz-partners/hometax-doum --skill tax-invoice-hometax -a windsurf -y
name: "tax-invoice-hometax" description: "개인사업자의 전자세금계산서·계산서·현금영수증 발급·수정·취소·조회 준비, 현금영수증 가맹점 가입 판정·신청과 미수금·정산 대조에 사용한다. 부가세 신고서 작성은 vat-hometax가 맡는다. 최종 발급은 본인이 진행하며 Pro 대조 엔진이 없으면 수동 확인으로 진행한다."
홈택스에서 **전자세금계산서를 발급 직전까지** 작성·점검하고, 사용자 확인 후 발급을 보조하는 범용 스킬. 특정 회사 전용이 아니다. 동료·일반 개인사업자 기준으로 동작한다.
연관 스킬:
상세:
1. **자동 발급 금지.** 매번 확인: `이 내용으로 세금계산서 발급 진행해도 될까요?` 2. 비밀번호·인증서 비밀번호·OTP·간편인증 **직접 입력 금지** 3. 거래처·금액·일자를 추측하거나 창작하지 않는다. 누락은 질문 목록으로 보고 4. 현재 홈택스 화면 필드·안내문 = 최종 근거 5. 주민번호·계좌 등은 마스킹 6. 보고 말미 표준 면책(아래 「보고 포맷」 하단 문구)을 반드시 삽입.
현금영수증 가맹점 가입 여부·가입 기한·가입 방법, 의무발행 기준, 발급·취소·매입·지출증빙·발급거부 요청은 [현금영수증 안내](references/cash-receipts.md)를 읽는다. 세금계산서 수정 사유를 그대로 적용하지 않으며 매출·승인·취소·실제 환불을 분리한다.
<!-- block:live-screen --> 실제 화면에서는 개인/사업자 상태와 추가 인증·설치·신고기간 제한을 확인한다. 조회 전 초기 값과 조회 후 결과, 작성 화면과 실제 접수·발급·납부를 구별한다. 빈 결과는 선택한 기간·자료원 안에서만 해석한다. <!-- /block -->
<!-- block:reuse-profile --> 허브 또는 사용자 지정 로컬 가명 프로필이 있으면 사업 가명·기간·과세유형·확인일을 먼저 대조하고 변경점·누락만 묻는다. 직원 없음과 외주 지급 없음은 별개이며, 미확인·미수집을 false·0원으로 채우지 않는다. 프로필이 없거나 이 스킬만 설치되어 있어도 필요한 항목만 직접 확인해 진행한다. 원본 식별정보·인증정보를 공통 프로필에 저장하지 않는다. <!-- /block -->
- 기준일(오늘 날짜): 시스템 시계에서 읽거나 사용자에게 확인. 추정 금지. 신고일·기한·경과일수 판단의 기준(작성일자·경과일수 판단용) - 작업: 신규 발급 / 수정세금계산서 / 조회만 / 미수금 점검 - (신규 발급이면) 거래처: 기존 / 신규 → 아래 두 레인으로 질문 수가 달라짐
필수 값이 없으면 **입력하지 말고** 먼저 질문한다. 사업자 미등록 거래처·주민번호 발급이 필요하면 별도 확인.
세금계산서 발급 요청을 받으면 이미 알려준 정보부터 정리하고, 기존·신규 여부가 불명확할 때만 아래 질문을 한다. 과거 발행 이력이 있어도 거래처로 저장되지 않았을 수 있으므로 실제 조회 결과로 흐름을 정한다.
> **이 거래처는 전에도 세금계산서를 발행하신 곳인가요, 아니면 이번이 처음인 신규 거래처인가요?**
사용자가 기존/신규를 모르면 사업자번호(또는 거래처명)로 홈택스 저장 여부를 조회해 확인한 뒤 아래 레인으로 진행.
이미 받은 정보는 **다시 묻지 않는다.** 저장 거래처는 팝업의 **조회** 실행 후 선택하고 확인한다. 처음 표시되는 0건을 저장 정보 없음으로 판단하지 않는다. 불러온 사업자번호·상호·성명·주소·이메일과 사용자가 의도한 거래처를 대조한다. 조회 후에도 정확한 대상이 없거나 빈칸이 있으면 누락된 정보만 한 번에 받는다. 아래 5항목도 이미 확정했다면 재질문하지 않는다:
1. **금액** — "공급가액인가요, 부가세 포함 합계인가요?" (자릿수까지 복창 확인) 2. **품목** — 직전 발행 이력이 보이면 "지난번과 같은 품목([품목명])인가요?"로 단축 3. **작성일자·공급일자** — **매번 새로 받는다** (일자는 절대 추측·재사용 금지 — 공급시기가 어긋나면 지연발급 가산세 위험) 4. **영수/청구** — "이 건은 대금을 이미 받으셨나요?" 5. **과세구분** — 직전 발행과 동일(과세/영세율/면세)한지 확인. 직전 이력이 영세율·면세이거나 이력을 알 수 없으면 **반드시 질문** (영세율 수출 건에 10% 세액을 붙이는 사고 방지. 면세 거래는 세금계산서가 아니라 '계산서' 대상이므로 발급 문서 종류부터 재확인)
조각조각 여러 번 묻지 말고 **한 번에 묶어서** 질문한다:
처음 발행하는 거래처네요. 아래 중 아직 알려주시지 않은 내용을 함께 알려주세요: 1. 사업자등록번호 (10자리), 상호·대표자명(성명)·주소 — 사업자등록증으로 확인 가능. 업태·종목도 화면에서 요구되면 확인 2. 세금계산서 받을 이메일 (모르면 비워두세요 — 발급 후 전송도 가능합니다) 3. 금액 (공급가액인지, 부가세 포함인지 함께) 4. 품목 (무엇에 대한 대금인지) 5. 작성일자·공급일자 6. 대금을 이미 받으셨나요, 아직인가요? (영수/청구) 7. 일반 국내 과세 거래인가요? — 수출(영세율)·면세 품목이면 알려주세요
7번이 영세율이면 세액 0 + 영세율 사유·서류 확인으로, 면세면 세금계산서가 아니라 **계산서** 발급 대상이므로 문서 종류부터 바로잡는다.
기존이든 신규든 발급 직전 **사업자번호 유효성(휴·폐업 여부)**을 한 번 확인한다. 기존 거래처라도 그 사이 폐업했을 수 있음 — 폐업 확인 시 발급 권유 금지, 사용자에게 알림.
홈택스 발급 화면에는 **`영수` / `청구`** 선택이 있고 기본값이 **`청구`**로 되어 있다. 실제 화면 상태와 대금 수령 여부를 반드시 대조한다. 이미 받은 답은 재사용하고, 미확정일 때만 다음을 질문한다:
> **이 건은 대금을 이미 받으셨나요, 아니면 아직 안 받고 청구하는 건가요?**
정의: **영수** = 대금 수령 완료 후 발행(영수증 성격) · **청구** = 대금 미수령, 청구 목적 발행. 세액은 동일.
| 모드 | 산출 | | --- | --- | | A. 신규 발급 보조 | 입력값 초안 + 발급 직전 QA | | B. 수정세금계산서 | 원본 조회 + 수정사유 확인 + QA | | C. 조회·다운로드 | 발급/수신 목록 정리 | | D. 대량 보조 | 건별 체크리스트 (한 건씩 확인) | | E. 미수금 점검 | 청구 발행 건 ↔ 입금내역 대조 + 미수금 리스트 + 경과일수 경고 |
기본: 인터뷰 → A 또는 B → 발급 직전 QA → 사용자 확인 → 발급 클릭(사용자 본인) → C로 검증
---
실제 화면을 조작하기 전에 **`references/issuance-workflow.md`를 반드시 읽고** 조회·알림·인증·미리보기·처리 지연의 상태별 절차를 따른다.
1. 로그인 세션 확인 (없으면 사용자 로그인) 2. **전체메뉴 → 계산서·영수증·카드 → 전자(세금)계산서 발급 → 전자(세금)계산서 건별발급** (메뉴명은 현재 화면 우선). 직접 주소가 메인으로 돌아오면 같은 주소를 재시도하지 말고 현재 메뉴로 이동 3. 발급 유형: 일반 / 위수탁 등 해당 메뉴 선택 4. 공급자(본인 사업장) 확인 5. 공급받는자 입력 — **기존 거래처면** 거래처 조회 팝업에서 조회 → 정확한 행 선택 → 확인 → 알림 처리 → 채워진 필드 대조. **신규면** 사업자번호 확인 후 실제 빈칸을 확인된 정보로 보완. 어느 경우든 **휴·폐업 여부 확인**(폐업이면 발급 중단·보고) 6. 이번 거래의 작성일자·공급일자 확인 후 입력. 작성일자와 품목 행의 월·일을 실제 화면에 맞춰 대조하고 별도 공급일자 입력란이 있다고 가정하지 않음 7. 품목, 규격, 수량, 단가, **공급가액**, **세액** 입력 8. 합계 검산: 공급가액 × 10% ≈ 세액 (과세 기준, 원 단위 반올림 차이 허용 범위는 화면 검증 따름) 8-1. **`영수`/`청구` 선택** — 화면 기본값은 **`청구`**. 인터뷰에서 "대금 이미 받음"으로 확인됐으면 **`영수`**, "아직 안 받음"이면 `청구`가 맞다. **AI는 어떤 값을 눌러야 하는지 안내만 하고, 라디오/버튼 클릭·선택은 사용자 본인**이 한다. 현재 라디오/버튼 상태를 함께 확인해 알려주고, "대금 받으셨다고 하셨으니 기본값 `청구`에서 **영수**로 바꿔 선택하시면 됩니다"처럼 안내한다. 9. 이메일 등 전송 옵션 확인 10. **발급 직전 QA** (`references/pre-issue-checklist.md`) 11. 모든 QA 통과 후 확인 문구 제시. 본문과 미리보기의 **발급하기는 모두 사용자 본인**이 클릭 12. 발급완료·승인번호·조회 결과로 확인. 지연되면 재발급하지 않고 상태·조회 조건·반영 지연 확인 (`references/issuance-workflow.md`)
1. 원본 전자세금계산서 조회 2. 수정 사유 선택 (기재사항 착오정정, 공급가액 변동, 환입, 계약해제 등 — **현재 화면 선택지** 따름) 3. 사유별 필수 필드 확인 (`references/amend-types.md`) 4. 변경 전·후 금액 대조표 작성 5. 사용자 확인 후 발급
상세 절차·경고 문구·보고 포맷: `references/receivables-check.md` — **반드시 읽고 그대로 따른다.**
`청구`로 발행한 건 중 입금 안 된 건을 찾아 미수금 리스트를 만드는 모드. 요약:
1. **시작 전 3고지** (생략 금지): ① 부가세는 발생주의 — 미입금이어도 전액 신고 대상, 빼면 매출 누락 ② 대손세액공제는 법적 대손 확정 시에만(단순 미입금 해당 없음) ③ 이 점검은 수금 관리용이며 신고 내용을 바꾸지 않음 2. 기간 확정(+약정 결제기일) → 발급 목록 엑셀 다운로드 (기간이 조회 단위를 넘으면 분할 다운로드·병합, 다운로드는 사용자 본인) 3. **정합성 게이트 ①**: 총 건수 = 영수 + 청구, 수정·취소 건 짝 처리(감
“부가세 신고, 무엇부터 준비해야 하죠?” “매출과 실제 입금이 맞는지 확인하고 싶어요.” “이번 달 세금 업무를 한 번에 정리해 주세요.” 혼자 챙기기 어려운 홈택스 업무를 AI와 함께 준비하세요. 소상공인·개인사업자·프리랜서를 위한 스킬 모음입니다. 사용하는 AI 앱에 설치하면, 평소 말하듯 요청해 필요한 자료와 다음 할 일을 안내받을 수 있습니다.
홈택스 도움 스킬의 진입점. 개인사업자의 개업부터 매출·지출, 신고, 납부·환급, 증명, 정정·폐업까지 홈택스 업무를 연결한다. '홈택스 도움 스킬로', '이번 달 세금 업무', '무엇부터 해야 할지' 같은 요청과 여러 업무가 섞인…
개인사업자의 종합소득세·모두채움 신고 준비, 소득·공제·기납부자료 확인과 국세·지방세 후속 확인에 사용한다. 세액을 직접 계산하지 않으며 예상세액 계산은 Pro 엔진이 탐지된 경우에만 연동한다. 자료 수집은 tax-prep-kr,…
개인사업자의 영수증·카드 내역을 부가세와 종소세 관점에서 분류하고 증빙 누락·중복·공제 후보를 점검할 때 사용한다. 분류 결과를 신고서에 넣는 화면 작업은 vat-hometax·income-tax-hometax가 맡는다. 공제…
개인사업자의 개업·변경·휴폐업, 사업자등록 신청·정정(업종 추가·통신판매업 연계), 사업용 카드 등록·사업용 계좌 신고·환급계좌·전자송달, 원천세 기초, 증명·납부·환급·정정과 신고자료 준비를 돕는다. 업무별 준비·현재 화면…
개인사업자의 일반·간이 부가세 신고 준비, 미리채움·매출·매입 대조와 신고 후 접수·납부·환급 확인에 사용한다. 신고 전 자료 수집·체크리스트는 tax-prep-kr, 카드·영수증 분류는 receipt-classify-kr이…
Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…
Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…