К основному содержанию
скилл CX Codex

sorted — скилл для Claude Code: что делает и как установить

Автоматизирует getSorted.de через браузер для выставления счетов, учёта расходов и подачи налоговых отчётов в Германии.

MIT 151 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill sorted -a claude-code
Открыть на GitHub

Что делает sorted

Скилл управляет сервисом getSorted.de без ручного кликания по интерфейсу. Он создаёт и выгружает инвойсы, ведёт учёт расходов и проверяет статус налоговых отчётов: квартальных UStVA, деклараций ZM и годовой отчётности.

Внутри работает связка из Chrome Beta с портом отладки 9222 и консольной утилиты agent-browser. Сессия Google сохраняется локально в каталоге ~/.chrome-beta-profile.

Без запущенного Chrome Beta с флагом --remote-debugging-port=9222 автоматизация не подключится к странице. Прямая отправка отчётов в Finanzamt через ELSTER и отправка писем со счетами требуют платного тарифа Sorted.

Какие задачи решает

  • создавать инвойсы для фрилансеров через веб-интерфейс getSorted.de
  • скачивать оригинальные PDF счетов без элементов браузерной панели
  • проверять сроки сдачи немецких налоговых отчётов UStVA и ZM
  • вносить новые чеки и операционные расходы в систему

Примеры запросов агенту

  • Создай инвойс в Sorted для клиента Acme Corp на сумму 1500 евро
  • Скачай готовый PDF для инвойса 2025-03-21 из getSorted.de
  • Покажи статус налоговых обязательств и дедлайны через tax status

Как установить sorted

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill sorted -a claude-code

2Вручную: положить файлы

~/.claude/skills/sorted/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/sorted/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о sorted

Как установить sorted в Claude Code?

Выполните команду npx skills add glebis/claude-skills --skill sorted -a claude-code. Конфигурация навыка запишется в ~/.claude/skills/sorted/SKILL.md.

Что делает скилл sorted?

Он автоматизирует действия в getSorted.de для выставления счетов клиентам, фиксации расходов и подготовки налоговых деклараций фрилансера в Германии.

Что нужно подготовить перед запуском?

Нужно запустить Chrome Beta с параметром --remote-debugging-port=9222, сохранить сессию в ~/.chrome-beta-profile и установить утилиту agent-browser.

Исходный текст

SKILL.md · MIT
---
name: sorted
description: Automate getSorted.de (Sorted) for freelancer invoicing, expense tracking, and German tax submissions (VAT, ZM, annual returns). Uses real-browser automation via Chrome Beta + agent-browser. Triggers on "create invoice", "sorted invoice", "download invoice", "submit VAT", "tax report", "sorted expenses", "/sorted", or any getSorted.de interaction.
---

# Sorted — Freelancer Tax & Invoicing Automation

Automates [getSorted.de](https://app.getsorted.de/) via real Chrome Beta browser for invoicing, expense tracking, and German tax report submissions.

## Prerequisites

- Chrome Beta with `--remote-debugging-port=9222` (use `/real-browser` launch sequence)
- Google account session persisted in `~/.chrome-beta-profile`
- `agent-browser` CLI installed

## Commands

### `invoice create`

Create a new invoice on Sorted.

**Required params:** client name, amount
**Optional:** hours, rate, description, due date, service date, client type (business/person)

### `invoice download <invoice-number>`

Download a properly formatted PDF from Sorted (not browser print).

### `invoice send <invoice-number> --email <email>`

Send invoice via email directly from Sorted (paid plan only). On free plan, downloads PDF and sends via Telegram instead.

### `invoice list`

List all invoices with status (paid/unpaid).

### `expense add`

Add an expense entry.

### `tax status`

Show current tax obligations, deadlines, and overdue reports.

### `tax preview <report-type> <period>`

Preview a tax report before submission.

### `tax submit <report-type> <period>`

Submit a tax report to Finanzamt via ELSTER (requires paid plan).

## Sorted Navigation

App URL: `https://app.getsorted.de/`

| Section | Sidebar link | Purpose |
|---------|-------------|---------|
| Dashboard | Sorted (logo) | Overview: taxes owed, income, expenses |
| Taxes | Taxes | Tax reports, deadlines, submissions |
| Income | Income | Invoice list, create/edit invoices |
| Expenses | Expenses | Expense tracking, receipts |
| Tax consultant | Tax consultant | Advisor connection |
| Personal details | Profile → Personal details | Freelancer info, Steuernummer |
| Bank accounts | Profile → Bank accounts (Beta) | Connected banks |
| Subscription | Profile → Subscription | Plan management |
| Import | Profile → Import your data | Bulk data import |
| Settings | Profile → Settings | App preferences |

## Tax Report Types

| Report | German name | Frequency | Description |
|--------|------------|-----------|-------------|
| Advance VAT | Umsatzsteuer-Voranmeldung (UStVA) | Quarterly | VAT collected on invoices |
| EU Summary | Zusammenfassende Meldung (ZM) | Quarterly | Revenue from EU customers |
| Annual Returns | EÜR + Einkommensteuererklärung | Yearly | Profit/loss + income tax |

## Invoice Creation Flow

### Step-by-step browser automation:

1. **Navigate:** `Income` → click `Add` → `Create invoice`
2. **Set client:** Click `Client details` area on invoice preview
   - Search existing clients or click `Add new client`
   - Choose `Business` or `Private person`
   - Fill: name, VAT/TIN, street, city, zip, country (autocomplete dropdown — type then click match), email (optional)
   - Click `Save` in dialog
3. **Set invoice date:** Click the date next to "Invoice date" (defaults to today)
4. **Set service date (REQUIRED):** Click the empty area to the right of invoice date labeled "Service date"
   - This is a **date range picker** — select start date, then end date
   - If same-day service, click the same date twice
   - **Without service date, Save will fail silently** — the field shows "Required" in red
   - The clickable element has class `clickable` and is positioned at ~x:734 y:413 on the invoice preview
   - If snapshot doesn't show it, use JS: find div with text "Service dateRequired" and click it
5. **Set due date:** Click "Select date" under "Due date" → pick from calendar
6. **Add line item:** Click `Add a line`
   - Fields: description (text), quantity (number), unit dropdown (h/pcs/etc), rate (number)
   - Click on collapsed values to re-edit them
7. **VAT:** Automatically 0% for Kleinunternehmer accounts. Shows "Service not taxable in Germany" in notes
8. **Save:** Click `Save` button. Title changes from "Add invoice" to "Edit invoice" on success

### Gotchas

- **Service date is mandatory** but easy to miss — it's not highlighted until you try to save
- **German number formatting:** dots are thousands separators (1.000 = one thousand), commas are decimals
- **Collapsed fields:** After saving, line item fields collapse to display-only. Click the displayed value to re-open the editable field
- **Invoice number:** Auto-generated sequentially (e.g., 2025-03-21). Can be edited by clicking it

## Invoice PDF Download Flow

**CRITICAL: Do NOT use Chrome CDP `Page.printToPDF` — it captures the entire page including sidebar and settings panel. Always use Sorted's native PDF.**

### Step-by-step:

1. Open the invoice (click from Income list, or navigate after creating)
2. Click `Save and send` button (top right, teal button)
3. An **"Email invoice"** dialog appears with:
   - To field (email)
   - Subject (auto-filled)
   - Message textarea
   - **Attachments section** at the bottom showing the PDF filename
4. Click the PDF link (e.g., `ALL3 DOO BELGRADE-2025-03-21-20260506.pdf`)
   - It's a `generic` element with `cursor:pointer` and `onclick`
   - The text matches pattern: `{CLIENT_NAME}-{INVOICE_NUMBER}-{DATE}.pdf`
5. PDF downloads to `~/Downloads/`
6. Close the dialog (click `Close` or `×`)

### Email sending (paid plan)

On paid plans, the "Email invoice" dialog is fully functional:

1. Fill `To` field with client email (`@e49`)
2. Edit `Subject` if needed (auto-filled as "Gleb Kalinin sent you an invoice (#INVOICE-NUMBER)")
3. Write a `Message` in the textarea
4. Toggle "Send a copy to my email" checkbox (checked by default)
5. Click `Email invoice` button (`@e15`) to send

On the **free plan**, the dialog shows "Sending invoices by email is not available in your plan" with a "Change my plan" link. The PDF download still works regardless.

### Fallback: Telegram delivery (free plan)

When email sending is unavailable, download the PDF and send via Telethon (see "Sending Invoice After Download" section below).

### PDF filename pattern
```
{CLIENT_NAME}-{INVOICE_NUMBER}-{YYYYMMDD}.pdf
```
Example: `ALL3 DOO BELGRADE-2025-03-21-20260506.pdf`

## Client Management

Existing clients are stored and reusable. When creating an invoice:
- The client picker shows all saved clients
- Search by name in the search box
- Edit/delete clients via small buttons next to each name

### Client fields (Business)
- Business name (required)
- VAT number / TIN (optional)
- Street & Number
- City
- Zip Code
- Country (autocomplete — type and click match)
- Email

### Client fields (Private person)
- First name, Last name
- Address fields same as business

## Sending Invoice After Download

After downloading the PDF, send via Telegram using Telethon:

```python
from telethon.sync import TelegramClient
import json
from pathlib import Path

config = json.loads((Path.home() / '.telegram_dl' / 'config.json').read_text())
session = str(Path.home() / '.telegram_dl' / 'user')

with TelegramClient(session, config['api_id'], config['api_hash']) as client:
    client.send_file("username", "/path/to/invoice.pdf", caption="message")
```

## Gleb's Sorted Account Details

- **Status:** Kleinunternehmer (no VAT charged)
- **Finanzamt:** Berlin - Wedding
- **VAT-ID:** DE369692682
- **Tax Number:** 2337201265
- **Bank:** Revolut Bank UAB, Zweigniederlassung
- **IBAN:** DE38 1001 0178 8157 1777 30
- **BIC/SWIFT:** REVODEB2
- **Plan:** Free (invoicing works, tax submission requires upgrade)

## Browser Session Setup

Always use the `/real-browser` skill's launch sequence. Session name should be unique per run:

```bash
SESSION=$(LC_ALL=C tr -dc 'a-z0-9' < /dev/urandom | head -c 6)
agent-browser --cdp 9222 --session "$SESSION" open "https://app.getsorted.de/"
```

Google login is persisted — no need to re-authenticate each time.

© glebis · MIT · glebis/claude-skills

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
plan-payroll ilyautov Скилл plan-payroll считает полную стоимость выплаты зарплаты с НДФЛ и взносами по правилам РФ 2026, строит прогноз денег и готовит напоминания по просроченным счетам, если на выплату не хватает. CX Codex +1 ★ 38звёзд репо Norman MCP Server norman-finance Связывает его с учётными данными компании в Norman: агент готовит счета, разбирает чеки и сверяет операции. Выполняет бухгалтерские задачи в Германии и Польше. CX Codex +1 ★ 65звёзд репо norman norman-finance Подключает финансовый сервис Norman к Claude Code для выставления счетов, сверки транзакций и подготовки налоговой отчётности в Германии и Польше. ★ 65звёзд репо quarterly-taxes openaccountant Скилл quarterly-taxes считает квартальные налоговые платежи по форме 1040-ES: берёт доход с начала года, эффективную ставку и правила safe harbor. CX Codex +1 461установок cowork-tax-prep-organizer OneWave-AI Скилл cowork-tax-prep-organizer для Claude Code ищет налоговые документы в папках и формирует пакет для бухгалтера. Сортирует файлы по формам, находит недостающие бланки и готовит вопросы для консультации с CPA. CX Codex +1 103установок linkedin-personal-branding schwepps Скилл linkedin-personal-branding разбирает ваш профиль LinkedIn прямо из браузера: фото, баннер, заголовок, раздел About, опыт, навыки и активность. Пригодится перед поиском работы или клиентов. CX Codex +1 824установок

Из того же набора51

Весь набор →
linear Скилл управляет задачами и проектами Linear через CLI. Попросите создать задачу, найти её в бэклоге или изменить статус. CX Codex +1 170установок session-finder Скилл session-finder индексирует сессии Claude Code эмбеддингами Gemini и находит нужную по описанию задачи, а потом открывает её или предлагает claude --resume. CX Codex +1 166установок timebuzzer-led Скилл timebuzzer-led для управления RGB LED на аппаратном устройстве timeBuzzer по протоколу MIDI. Задаёт цвет, эффекты (пульс, стробоскоп, радуга, затухание) и статус-сигналы прямо из кода. CX Codex +1 165установок session-anonymizer Скилл session-anonymizer удаляет персональные данные из заметок и транскриптов терапевтических или коучинговых сессий. Работает локально через трёхслойный пайплайн. CX Codex +1 159установок rag-eval Скилл rag-eval запускает сетку тестов для RAG-пайплайна с ограничением бюджета и ранжирует варианты. CX Codex +1 150установок wow-digest Скилл wow-digest для Claude Code собирает письма из рассылок и посты Telegram, отбирает неожиданные материалы и добавляет их в ежедневную заметку для утреннего обзора чтения. CX Codex +1 145установок tg-responder Скилл tg-responder для Claude Code помогает проверять черновики ответов в Telegram, одобрять отправку и отслеживать сообщения без ответа, чтобы держать inbox под контролем и не забывать о важных переписках. CX Codex +1 145установок retrospective Скилл retrospective проводит ретроспективу сессии, находит ошибки и правки пользователя, а затем сохраняет выводы в файлы памяти, правила CLAUDE.md или текст скиллов. CX Codex +1 135установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой