Helps sole traders and freelancers prepare their Hometax tax work, from business registration and monthly VAT to income tax, tax invoices and receipts. Ask in plain words what to do next, and it lists the documents you need and the steps to take.
Claude Code
> /plugin marketplace add lbiz-partners/hometax-doum> /plugin install hometax-doum@lbiz-partners
Codex
$ npx skills add lbiz-partners/hometax-doum -a codex
Cursor
$ npx skills add lbiz-partners/hometax-doum -a cursor
Gemini CLI
$ npx skills add lbiz-partners/hometax-doum -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add lbiz-partners/hometax-doum$ copilot plugin install hometax-doum@lbiz-partners
OpenCode
$ npx skills add lbiz-partners/hometax-doum -a opencode
Windsurf
$ npx skills add lbiz-partners/hometax-doum -a windsurf
“부가세 신고, 무엇부터 준비해야 하죠?”
“매출과 실제 입금이 맞는지 확인하고 싶어요.”
“이번 달 세금 업무를 한 번에 정리해 주세요.”
혼자 챙기기 어려운 홈택스 업무를 AI와 함께 준비하세요. 소상공인·개인사업자·프리랜서를 위한 스킬 모음입니다. 사용하는 AI 앱에 설치하면, 평소 말하듯 요청해 필요한 자료와 다음 할 일을 안내받을 수 있습니다.
버전: 4.4.1 · 무료 스킬 6종 · 처음 시작 가이드
4.4.1: 세금계산서 거래처 조회·알림·빈칸 처리, 미리보기와 처리 지연 시 중복 방지, 영수/청구 최종 확인을 보완했습니다.
세무 용어를 몰라도 괜찮습니다. 지금 해야 할 일을 평소 쓰는 말로 알려주세요. 필요한 자료와 확인 순서를 함께 정리합니다.
| 지금 필요한 일 | 이렇게 요청하세요 | 받게 되는 도움 |
|---|---|---|
| 무엇부터 할지 모르겠어요 | “이번 달 세금 업무 정리해줘.” | 사업장 상황에 맞는 할 일과 준비자료 목록 |
| 부가세 신고가 다가와요 | “부가세 신고 준비부터 도와줘.” | 일반·간이과세 구분, 매출·매입 자료, 제출 전 확인 |
| 종합소득세를 준비해요 | “종합소득세 신고 도와줘.” | 필요한 자료, 신고 화면 순서, 신고 후 확인할 일 |
| 세금계산서를 발행해야 해요 | “세금계산서 발급 전에 점검해줘.” | 거래처·금액·청구/영수 확인, 발급·수정·조회 안내 |
| 카드·영수증이 쌓였어요 | “사업 관련 지출을 분류해줘.” | 지출 분류, 증빙 누락과 공제·불공제 후보 확인 |
| 아직 못 받은 돈이 있어요 | “계산서와 입금내역을 확인해줘.” | 미수금·부분입금·선금 등 확인할 거래 정리 |
| 면세사업자예요 | “사업장현황신고 준비해줘.” | 병의원·동물병원·약국·학원·주택임대·인적용역 등의 자료·첨부 안내 |
| 외주비를 지급했어요 | “어떤 자료와 신고가 필요한지 알려줘.” | 원천세·지급명세서 준비 목록 |
| 증명서가 필요해요 | “대출에 필요한 세무서류를 점검해줘.” | 문서 종류·귀속기간·발급일·누락 확인 |
| 신고 후에도 불안해요 | “신고·납부·환급 상태를 나눠 확인해줘.” | 접수증·납부 결과·환급 입금을 각각 확인 |
개업·사업자등록 정정·휴폐업·현금영수증·신고 정정·기한연장 등도 포함해 개인사업자 24개 업무 묶음을 안내합니다. 전체 업무 목록에서 업무별 지원 수준을 확인할 수 있습니다.
설치한 AI 앱의 새 대화에 아래 문장을 복사하세요.
홈택스 도움 스킬로 내 사업장 상황부터 확인해줘.
업종, 과세유형, 직원 유무, 확인할 기간 중 필요한 것만 질문하고,
이번 달 할 일과 준비자료를 정리해줘.
자료가 없거나 확인하지 않은 항목은 미확인으로 남겨줘.
이후에는 “부가세부터 준비하자”, “이 파일에서 빠진 자료를 찾아줘”처럼 이어가면 됩니다. 스킬이 여러 개 설치되어 있다면 홈택스 도움 스킬로라는 표현을 함께 말해 주세요.
사용 흐름은 사업장·기간 확인 → 자료 준비 → 점검 → 홈택스 화면 확인 → 결과 증빙 확인입니다. 실제 화면을 함께 보려면 AI 앱에 브라우저 연결 도구가 필요합니다. 로그인·인증과 마지막 제출·발급·납부는 본인이 진행합니다.
Free는 필요한 자료와 화면 순서, 수동 점검을 돕습니다. Pro는 계산과 여러 파일의 일괄 대조를 더한 별도 구성입니다.
| 기능 | Free · 현재 공개 6종 | Pro · 공개 예정 9종 |
|---|---|---|
| 24개 업무의 준비자료·화면 안내 | 제공 | 포함 |
| 9개 업종·상황별 준비목록 | 제공 | 포함 |
| 영수증 분류·미수금 수동 점검 | 제공 | 포함 |
| 종소세·원천징수 예상액 계산 | 준비자료 안내 | 지원 범위 내 계산·검산 |
| 매출·정산·입금 파일 대조 | 수동 확인표 | 파일 변환·일괄 대조·보고서 |
| 업종별 8개 계산 모드 | 자료 준비·수동 확인 | 지원 조건 내 계산·화면 금액 비교 |
| 증명서 기간·발급일·누락 점검 | 수동 확인표 | 입력한 서류 조건 일괄 대조 |
| 사업자등록 신청·정정 | 기본 안내 | 전용 스킬로 상세 안내 |
Pro는 Free 6종에 종소세 준비·계산, 원천세, 사업자등록 전용 스킬 3종을 더한 구성입니다. Pro의 계산 엔진과 전용 스킬은 현재 이 공개판에 포함되지 않습니다. 법인세도 이 패키지에 포함되지 않습니다.
각 구성은 사용자가 직접 수행하는 업무의 자료 정리·계산·화면 확인을 돕는 소프트웨어입니다. 신고 대행이나 개별 사안의 전문 세무 판단을 제공하는 서비스가 아니며, 로그인·인증과 최종 제출·발급·납부는 사용자가 직접 진행합니다.
이 저장소의 GitHub 스타가 10,000개를 넘으면, 위 표의 Pro 범위에 있는 스킬과 계산 엔진을 무료로 공개합니다.
홈택스 도움 스킬은 사업자가 AI를 활용해 직접 업무를 챙길 수 있도록 돕는 공개 프로젝트입니다. 현재는 Free 6종을 사용할 수 있으며, Pro 구성은 스타 10,000개 초과를 기념하는 공유 이벤트로 공개합니다. 법인세는 이번 공개 범위에 포함되지 않습니다.
공개 일정·설치 방법·이용 조건은 기준 달성 후 이 저장소에서 안내하겠습니다. 도움이 되셨다면 GitHub 스타로 관심을 남겨 주세요.
온라인판매·소매, 음식점, 제조, 프리랜서, 학원·면세 서비스, 병의원·의료업, 상가임대, 주택임대, 수출·과세면세 겸영의 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 대화창에서 다음 두 줄을 차례로 입력하세요. 윈도우와 맥이 같습니다.
/plugin marketplace add lbiz-partners/hometax-doum
/plugin install hometax-doum@lbiz-partners
무료 스킬 6종이 함께 설치됩니다. 업데이트할 때는 /plugin marketplace update lbiz-partners로 마켓플레이스를 갱신하고 설치된 플러그인의 버전을 확인하세요.
.skill 업로드를 지원하는 앱이라면전달받은 ZIP의 데스크탑용 .skill 파일 6개를 앱의 스킬 설정에 추가하세요. 터미널과 Python이 없어도 됩니다. 설치 방식은 처음 시작 가이드에 정리했습니다.
2_CLI용_폴더스킬 폴더를 사용합니다.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개 대표 경로의 메뉴 진입·로그인 요구·공개 조회와 가상자료 모의계산을 구분합니다. 모든 하위 기능이나 실제 신고·발급·납부를 완료했다는 뜻은 아닙니다. 업무별 공개 확인 범위
본 도구는 신고 준비를 돕는 소프트웨어입니다. 이용 조건은 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·원격 배포 완료를 뜻하지 않습니다.
Free 모드 또는 Pro 탐지를 선언합니다(파일을 볼 수 없는 앱에서는 Free 모드로 진행). Free 모드에서는 허브 본문과 보고에서 Pro 도구 이름을 쓰지 않고 안내·자료 준비·수동 대조로 같은 절차를 끝까지 진행합니다.docs/verification/)으로 옮겨 허브 스킬이 가벼워졌습니다. 업무 목록 표는 JSON에서 생성합니다..skill 업로드, 폴더 설치를 표로 구분했습니다.install.py / install.ps1과 Mac·Linux용 install.sh를 함께 제공합니다. Python 3.10이면 운영체제가 달라도 같습니다.~/.aside/u/0/skills/user)로 맞췄습니다.소상공인·개인사업자·1인 대표가 필요한 자료를 정리하고 실무를 이어갈 수 있도록 도구와 활용 안내를 만듭니다.
홈택스 업무 준비 외에도 사업 운영에 AI를 활용하고 싶으신가요? 유튜브 이상수의 사장님 브리핑에서 소상공인·개인사업자를 위한 사업 운영과 AI 활용 콘텐츠를 시청해 보세요.
본 스킬은 신고 준비와 화면 안내를 돕는 참고용 소프트웨어이며 「세무사법」 제2조의 세무대리를 수행하지 않습니다. 최종 세무 판단·신고·납부의 책임은 이용자 본인 또는 위임받은 세무 전문가에게 있습니다.
LICENSE — 개인·사내 사용, 수정, 비상업적 공유 가능. 재판매·Pro 재배포는 금지합니다.
개발·검증 안내
개발용 훅은 저장소 개발 세션에만 적용하며 고객 ZIP에는 넣지 않습니다. 스킬 사용자에게 개발용 작업 폴더를 열도록 요구하지 않습니다.
Stars on GitHub
A skill that shapes Claude Code's output for readers with ADHD: it leads with the next action, numbers multi-step work, restates state across turns, drops tangents, gives specific time estimates, and makes progress visible. Invoke it with /i-h.
@ayghriGives your AI agent working knowledge of Obsidian, so it can read and write notes, build Bases database views and JSON Canvas mind maps, and turn web pages into clean Markdown for your vault.
@kepanoGives product managers step-by-step help with discovery, prioritization, strategy, launch and growth work, so they get structured outputs instead of loose text. Also includes skills for reviewing AI-built code before shipping.
@phurynFormerly: Colleague Skill / colleague-skill.
@titanwingsHelps sole traders and freelancers prepare their Hometax tax work, from business registration and monthly VAT to income tax, tax invoices and receipts. Ask in plain words what to do next, and it lists the documents you need and the steps to take. Install it with the command on its page. It includes hometax-tax-hub, income-tax-hometax, receipt-classify-kr. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it