Налоговый органайзер
elderengineer/tax-organizerСкилл для Claude Code, который читает PDF-квитанции, W-2, 1099 и таблицы, сортирует файлы по папкам, рассчитывает амортизацию и формирует готовые CSV-отчёты для бухгалтера.
Установка
npm install -g @anthropic/claude-codeREADME
Tax Organizer — Руководство по настройке
Организует личные и консультантские налоговые документы (W-2, 1099, расходы на аренду, пожертвования, командировки) и генерирует готовые к проверке CSV-отчёты для бухгалтера. Работает на базе Claude Code.
Что умеет этот скилл
- Читает PDF-квитанции, счета, W-2, 1099 и экспорты таблиц
- Сканирует документы и помогает настроить бизнес-направления — без ручного создания папок
- Автоматически переименовывает и сортирует файлы по нужным папкам
- Рассчитывает амортизацию арендной недвижимости
- Сравнивает фактические расходы в командировках со ставками GSA per diem
- Генерирует CSV-отчёты: Schedule E, W-2, 1099, пожертвования и командировки
Шаг 1 — Установка Claude Code
Claude Code — консольный инструмент от Anthropic. Предварительно требуется Node.js 18+.
Установка Node.js (если ещё не установлен): https://nodejs.org — скачайте LTS-версию.
Установка Claude Code:
npm install -g @anthropic/claude-code
Вход в систему:
claude
Следуйте инструкциям для входа через учётную запись Anthropic. Если её нет — создайте бесплатный аккаунт на https://claude.ai.
Шаг 2 — Установка необходимых скиллов
Скиллы — это команды Claude Code, хранящиеся в виде Markdown-файлов. Для работы проекта нужны три скилла: pdf, xlsx и сам налоговый органайзер.
Скиллы хранятся в ~/.claude/commands/ (домашняя директория, доступна во всех проектах).
Создание папки для команд:
mkdir -p ~/.claude/commands
Установка скилла PDF
Скилл PDF включён в репозиторий в папке skills/pdf/.
cp skills/pdf/SKILL.md ~/.claude/commands/pdf.md
Установка скилла XLSX
Скилл XLSX включён в репозиторий в папке skills/xlsx/.
cp skills/xlsx/SKILL.md ~/.claude/commands/xlsx.md
Установка скилла Tax Organizer
cp SKILL.md ~/.claude/commands/tax-organizer.md
Проверка установки всех трёх скиллов:
ls ~/.claude/commands/
# Должно отображаться: pdf.md xlsx.md tax-organizer.mdШаг 3 — Создание папки для налогового года
Создайте отдельную папку для налоговых документов. Одна папка — один налоговый год.
mkdir ~/Documents/Tax-2025
cd ~/Documents/Tax-2025Поместите все документы в эту папку — квитанции, счета, W-2, 1099, экспорты таблиц, всё что есть. Документы можно добавлять позже: скилл обрабатывает только новые файлы при каждом запуске.
Шаг 4 — Запуск Tax Organizer
Откройте Claude Code в папке с налоговыми документами:
cd ~/Documents/Tax-2025
claudeЗатем введите команду:
/tax-organizer
Первый запуск. Скилл выполнит следующее:
- Запросит налоговый год, статус подачи и имя составителя
- Просканирует все помещённые документы
- Определит вероятные бизнес-направления по документам (арендная недвижимость, фриланс, партнёрства и т.д.)
- Проведёт через подтверждение каждого направления и заполнение недостающих данных (стоимость приобретения, дата ввода в эксплуатацию и т.д.)
- Создаст структуру папок и сгенерирует все конфигурационные файлы
README.mdдля бизнес-направлений - Организует, переименует файлы и сформирует отчёты
Последующие запуски. Добавьте новые документы в папку и снова запустите /tax-organizer. Скилл обнаружит только новые файлы и пропустит уже обработанные. Если новые документы указывают на новое бизнес-направление, скилл предложит его настроить.
Структура папок (создаётся автоматически)
Tax-2025/
├── README.md # Конфигурация налогового года
├── Rental-123-Main-St/ # По одной папке на каждый бизнес/объект аренды (создаётся скиллом)
│ ├── README.md # Конфигурация бизнеса (адрес, стоимость, поездки)
│ └── 2024-03-15 Plumber Co - Repairs - Pipe fix.pdf
├── W2s/
├── 1099s/
├── Donations/
├── Unclassified/ # Файлы, требующие ручной проверки
├── Reports/ # Сгенерированные CSV — готовы для бухгалтера
│ ├── schedule-e-draft.csv
│ ├── business-trips.csv
│ ├── donations-summary.csv
│ ├── w2-summary.csv
│ └── 1099-summary.csv
└── .processed-files.log # Внутренний журнал отслеживания (не редактировать)
Добавление документов
Документы можно помещать в любое место внутри налоговой папки — скилл классифицирует их автоматически:
| Документ | Куда помещать |
|---|---|
| Формы W-2 | Куда угодно — перемещаются в W2s/ |
| 1099 (NEC, MISC, INT, DIV, K, B, R, S) | Куда угодно — перемещаются в 1099s/ |
| Квитанции и счета по аренде | Куда угодно — сопоставляются с нужным объектом |
| Квитанции о пожертвованиях | Куда угодно — перемещаются в Donations/ |
| Квитанции по командировкам | Куда угодно — сопоставляются по дате с поездками в README бизнеса |
| Экспорты банков в Excel / CSV | Куда угодно — извлекаются через /xlsx |
| Всё остальное | Перемещается в Unclassified/, если классификация неясна |
Советы
- Просто добавьте и запустите — предварительная сортировка и переименование не нужны. Скилл разберётся сам.
- Никогда не удаляйте
.processed-files.log— именно по нему скилл отслеживает выполненные операции. - Оригиналы сохраняются — скилл копирует файлы в организованные места; исходники остаются нетронутыми.
- Добавляйте документы в любое время — запускайте
/tax-organizerпосле каждой партии; уже обработанные файлы пропускаются. - Проверяйте
Unclassified/после каждого запуска на предмет файлов, требующих ручного назначения. - Отчёты всегда перегенерируются из полной истории, поэтому они всегда актуальны.